ropensci / eph

Herramientas para procesamiento de la base usuaria de la EPH
https://ropensci.github.io/eph/
Other
58 stars 18 forks source link

Collaboration Guidelines #5

Open DiegoKoz opened 5 years ago

DiegoKoz commented 5 years ago

Bienvenides :tada: :tada: :tada:

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:

  1. Hace un fork de este repositorio
  2. Agregues tu función como un archivo .R en la carpeta R/ con el mismo nombre que la función
  3. 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
  4. Recordá que para que tu función se pueda utilizar, al final de la documentación debes agregar un #' @export
  5. Controla que los tipos y valores de los parametros de tu función estén bien (para un ejemplo, podes mirar get_microdata.r
  6. Agrega las dependencias en el archivo DESCRIPTION
  7. Chequea el paquete con devtools::check()
  8. 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 5 years ago

Nombres de Funciones

Para mantener la cohesión interna de la librería, decidimos el siguiente esquema de nombres para funciones: