Cómo organizamos el Github de Datos Argentina
Estábamos desordenados. Mejoramos bastante. Nos falta un poco.
A partir del esfuerzo de los últimos meses, estamos orgullosos y expectantes del Github de Datos Argentina. Orgullosos, por todo el esfuerzo que hay por detrás de los repositorios y por todo lo que logramos hacer hasta ahora. Expectantes, porque queremos lograr muchísimo más.
Nos encantaría que participes
Primero, porque tenemos un problema de números. Somos pocos pero queremos hacer mucho. Abrirnos a la comunidad nos da la posibilidad de ser muchos más.
Después, porque creemos que en casa de herrero, cuchillo de… ¿metal?. Lo cierto es que sería muy raro abrir datos pero no código. Casi siempre, la gente de datos abiertos y la gente de código abierto, es la misma.
Nos gustaría reducir el número de reinvenciones de ruedas.
Por último, y más importante, nos gustaría reducir el número de reinvenciones de ruedas. ¿Construimos una herramienta que otras organizaciones pueden reutilizar? Espectacular. ¿Tenemos un problema que se puede resolver con una herramienta que ya existe? Más espectacular todavía.
Cómo nos organizamos
Ya teníamos nuestros proyectos en Github. Pero nos dimos cuenta de que, al igual que con los datos, no alcanza con que el código esté abierto. Es necesario que esté bien documentado. Resulta difícil colaborar cuando un proyecto no explica qué es o qué hace, cuando el código no se entiende, cuando no sabemos si podemos crear un issue o un pull request, o de qué manera hacerlo.
Entonces, nos pusimos a ordenar nuestro Github:
- Escribimos un código de conducta y lo agregamos a nuestro repositorio de estándares.
- Agregamos un CONTRIBUTING y un ISSUE_TEMPLATE a nuestros repositorios. Ahora, cuando nos creás un issue, te sugerimos cómo contribuir y te contamos qué tipo de información nos sirve que incluyas.
- Trabajamos en la metadata de los repositorios:
*Estandarizamos la nomenclatura de los repositorios (minúsculas, separados por guión medio) y tratamos de que tengan nombres intuitivos.
*Repasamos los repositorios para asegurarnos de que todos tengan descripciones y READMEs completos.
*Creamos plantillas de READMEs para acelerar su creación en proyectos nuevos.
- Pulimos los estándares de código, que están en progreso y aceptando recomendaciones. De esta manera, antes de hacernos un pull request, podés asegurarte de que cumpla con los estándares.
Qué nos falta
Algunos de nuestros proyectos tienen, además de lo mencionado anteriormente, integración con Travis, tests, versionado, y documentación basada en el código. Esta belleza, la librería de pydatajson, es uno de ellos. Pero queremos que sea la norma y no la excepción. Por eso, estamos trabajando en nuestro proceso de versionado, en integración continua para todos nuestros proyectos, y en mejorar la calidad y la producción de los tests.
Creemos que estamos un poco más ordenados, pero si encontrás desorden, avisanos. ¡Te invitamos a seguir la conversación por Github!