Collaboration Guidelines
Opened this issue · 1 comments
DiegoKoz commented
Bienvenides 🎉 🎉 🎉
El objetivo de esta librería es construir un Toolbox para el procesamiento de la Encuesta Permanente de Hogares (indec)
Para agregar tu función te pedimos que sigas los siguentes pasos:
- Hace un fork de este repositorio
- Agregues tu función como un archivo .R en la carpeta R/ con el mismo nombre que la función
- Documenta la misma con roxygen2 aclarando su funcionalidad, los parámetros y un ejemplo de uso. Para ver como se documenta poder revisar otra de las funciones en ese mismo directorio
- Recordá que para que tu función se pueda utilizar, al final de la documentación debes agregar un
#' @export
- Controla que los tipos y valores de los parametros de tu función estén bien (para un ejemplo, podes mirar get_microdata.r
- Agrega las dependencias en el archivo DESCRIPTION
- Chequea el paquete con
devtools::check()
- Si todo funciona bien, entonces hace un pull request
obs. Te pedimos que en la medida de los posible trates de seguir la guía de estilo del Tidyverse que va a simplificar mucho la lectura del código y la usabilidad de la librería
obs. En un futuro esperamos agregar test de la librería con testthat.
DiegoKoz commented
Nombres de Funciones
Para mantener la cohesión interna de la librería, decidimos el siguiente esquema de nombres para funciones:
- Las mismas deben ser escritas en inglés, al igual que los parametros que utilicen.
- funciones que descargan datos
get_
{microdata | poverty_lines} - funciones que calculan cosas
calculate_
{poverty | tabulates} - funciones que organizan los datos
organize_
{labels | panels} - funciones que estiman cosas
estimate_{confint}