Bienvenidos a "#DisponibleEnCordoba"
“#DisponibleEnCordoba” quiere visualizar el patrimonio público sin uso de Córdoba. En Córdoba existen decenas de edificios públicos abandonados en buen estado de conservación. Mientras tanto, numerosas asociaciones, colectivos y organizaciones carecen de espacio. Para más información visitar la descripción del proyecto en [colaborativa.eu] 2.
Descripción
"#DisponibleEnCordoba" es una aplicación Web abierta, disponible en [GitHub] 18, de geolocalización y visualización de edificios públicos abandonados en Córdoba basada en OpenStreetMaps, el servidor de mapas MapBox y GoogleSpreadSheet. Este proyecto de código libre está distribuido bajo licencia MIT. Los textos e imágenes bajo una licencia creative commons CC BY 3.0 ES.
Se basa en datos abiertos en formato JSON y CSV, de manera que cualquier persona pueda acceder a ellos y generar trabajos derivados.
¿Cómo contribuir a #DisponibleEnCordoba?
Añadiendo edificios a la lista
Si queréis contribuir a añadir edificios públicos abandonados al mapa envíanos un email a info@colaborativa.eu incluyendo:
- Localización del edificio abandonado
- Estado actual
- Fotografías
- Links a prensa o información oficial.
Desarrollando software
Si queréis contribuir en el desarrollo software del proyecto os recomendamos:
- Consultar la lista de "issues" o "features" (problemas o mejoras) del proyecto en GitHub, elegir alguno, asignároslo y poneros manos a la obra. ¡Así de fácil!
- Si has encontrado un problema puedes documentarlo en la lista de "issues" del proyecto en GitHub
- Si has identificado alguna mejora puedes documentarla en la lista de "features" del proyecto en GitHub
- También puedes consultar la lista de "issues" actual y realizar aportaciones a través de comentarios.
Para garantizar una buena coordinación entre todos los contribuidores de "#DisponibleEnCordoba", nos gustaría animaros a seguir una serie de recomendaciones:
- Consultar la lista de mejoras existentes y solicitar nuevas
- Documentar "bugs" o comportamientos extraños
- Listar las tareas pendientes de desarrollo
- Utilizar el mismo estilo de código que en el resto del proyecto
- Antes de enviar un "pull request" de una mejora, asegurarse que funciona correctamente y que ha superado una serie de tests
- No olvidar referenciar "issues" en Git Commits cuando se resuelvan.
Por nuestro lado nos comprometemos a mantener la lista de ["issues" y "features"] 16 actualizada en todo momento.
Si no habéis colaborado nunca en un proyecto abierto os recomendamos leer el [método de trabajo del equipo de GitHub] 4 y en especial la sección de "Contributors".
Instalación
Clonar el repositorio para obtener una copia en local
$ git clone git://github.com/colaborativa/DisponibleEnCordoba.git
Si deseas contribuir al proyecto entonces haz un Fork del repositorio
Primero hacer click en el botón "Fork" del proyecto #DisponibleEnCordoba en [GitHub] 18.
A continuación clonar el "Fork" en tu ordenador:
$ git clone https://github.com/username/DisponibleEnCordoba.git
Consultar más información sobre [qué es un Fork] 17.
Sobre los archivos del proyecto
- /ext/: directorio con librerías javascript de terceros necesarias; jquery, mapbox y underscore
- /img/: directorio con imágenes del proyecto
- /css/: directorio con hojas de estilo CSS
- /js/: directorio con archivos Javascript/jQuery que hemos desarrollado de forma espécifica para "#DisponibleEnCordoba"
dec-google_docs.js v1.0: función que actúa como interfaz con Google spreadsheet
dec-principal.js v1.0: función principal que añade los marcadores en el mapa de acuerdo con la información contenida en Google spreadsheet.
- /docs/: directorio con el código documentado en formato HTML.
[dec-google_docs.html] 20: documentación del código en "dec-google_docs.js"
[dec-principal.html] 19: documentación del código en "dec-principal.js".
Dependencias con otras librerías
¿Cómo actualizar tu FORK de #DisponibleEnCordoba con las últimas mejoras?
Ir a la branch master en local de tu Repositorio (clone de DisponibleEnCordoba) y desde el Terminal corre los siguiente comandos:
$ git remote add upstream https://github.com/colaborativa/DisponibleEnCordoba.git
Este comando añade otro repositorio remoto que apunta al Original, para ver los existentes ejecuta "git remote -v".
$ git fetch upstream
A continuación, hemos cargado todos los commits, incluyendo branches y tags.
$ git pull upstream gh-pages
Por último, hacemos un merge de branch gh-pages del repositorio original a la que nos encontremos actualmente del repositorio clonado local. Si hubiera conflictos aparecerían en este momento.
Documentación oficial
Más información sobre el proyecto en [la web propia] 1 y en colaborativa.eu. La documentación del código Javascript/JQuery está disponible en dec-principal.html y [dec-google_docs.html] 20.
Autores y créditos
"#DisponibleEnCordoba" v1.0 es un proyecto impulsado y mantenido por [colaborativa.eu] 5. Posteriormente liberado y publicado en [GitHub] 18 para fomentar su utilización en otras aplicaciones de geolocalización, y su continua evolución y mejora por parte de todo el mundo que desee contribuir al proyecto.
Muchas gracias a todos los [contribuidores] 16.
"#DisponibleEnCordoba" utiliza el proyecto de código abierto [MapBox] 7 All rights reserved, Copyright (c). Consultar los términos de su licencia para más información .
"#DisponibleEnCordoba" utiliza el componente de código abierto [Underscore] 11, Copyright (c) 2009-2013 Jeremy Ashkenas, DocumentCloud. Consultar los términos de su [licencia] 14 para más información.
Contacto
Puedes escribirnos un email a info@colaborativa.eu.