Propósito: Presentar una mirada panorámica de la documentación y sus objetivos, así como la forma de navegación sugerida y los espacios de interacción entre el aprendiz y la comunidad y lo que se espera de la misma y los compromisos de las partes.
Esta es una guía que te ayudará al aprendizaje autonónomo de las prácticas, tecnologías y conceptos que abordamos en nuestras hackatones y talleres, llamados Data Weeks y Data Rodas (que ocurren entre edición y edición de las primeras).
La documentación está en construcción permanente y no es autocontenida, sino que presupone un papel activo del aprendiz, que complementa lo que está en dichas guías, pregunta, busca documentación extra y tiempo para practicar. Esperamos, que dicho papel proactivo nos permita mejorar las prácticas de aprendizaje, así como las infraestructuras y la documentación que las soportan. Esto implica que tanto comunidad como aprendiz estarán dispuestos a aprender mutuamente y a asumir sus roles de manera proactiva.
Convenciones
Las palabras en cursiva serán usadas para enfatizar ciertos términos y para referirse a extrangerismos o términos en otros idiomas. Por ejemplo: bootstrapping.
Las fuentes true type, serán empleadas para referirse a comandos y archivos. Por ejemplo: abrimos el archivo
Documentos/mi-archivo.txt.Los términos colocados entre signos de mayor y menor qué (también llamados paréntesis angulares), dentro de true type corresponden a variables que deben ser reemplazadas, de acuerdo al contexto. Por ejemplo: ingresamos con
<usuario>@myrepo.com, supone que el usuario es el que cambia, dependiendo del nombre de usuario de cada quién y que el resto se mantiene constante, para todos.Algunas lecciones tendrán unos "metadatos" al inicio, que permiten saber rápidamente que pretende la lección y que prerequisitos supone. Por ejemplo:
- Propósito: Aprender que es un etherpad, cómo y dónde crearlos, cuáles son los elementos de su interfaz.
- Ejercicio práctico: Crear un Etherpad y compartirlo con los demás talleristas.
- Prerequisitos:
- Lección: Presentación.
Al final de la página pueden encontrarse unos controles de navegación, que sugieren secuencias para continuar el aprendizaje. Los que van con precedidos del signo
<son lecciones anteriores, y los que van seguidos del signo>son lecciones siguientes. Por ejemplo:[Indice] [< Presentación] [Markdown >]
nos indica que antes de la lección actual se sugiere haber leído la Presentación y continuar con la lección sobre Markdown.
Dónde conseguir más ayuda o reportar un error o hacer una sugerencia
Los espacios comunitarios virtuales están listados en la sección de contactos para Grafoscopio, así que visíta los enlaces y te esperamos, tanto en nuestro canal de Telegram, como en la lista de correo.
También nos reunimos periódicamente cara a cara y hacemos streamming en HackBo. Para saber cuándo, consulta y vincúlate a los canales virtuales antes mencionados.
Finalmente, esperamos que este papel proactivo de todos los miembros de la comunidad se vea reflejado en el hecho de que por tu propia cuenta puedas incorporar las sugerencias y cambios que te gustaría ver en la documentación y los espacios virtuales y analógicos con los que contamos, con los saberes que iremos adquiriendo. Así que puedes también ver nuestro listado de boletas (tickets) y en caso de que no encuentres el tuyo ya reportado crees uno nuevo, o si encuentras uno que puedes resolver, hagas un commit a nuestro repositorio (acá mismo aprenderás como hacerlo).
Por dónde continuar
Sigue el menú de navegación inferior y ve siguiendo los documentos. Y recuerda, los espacios comunitarios están allí para darte la bienvenida, orientarte y que aprendamos mutuamente.