desarrollo:convenciones:start
Diferencias
Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa | ||
desarrollo:convenciones:start [2015/01/02 19:03] – creado son0p | desarrollo:convenciones:start [2020/02/11 17:18] (actual) – editor externo 127.0.0.1 | ||
---|---|---|---|
Línea 1: | Línea 1: | ||
====== Convenciones para la documentación en este wiki ====== | ====== Convenciones para la documentación en este wiki ====== | ||
+ | Cada persona escribe de manera diferente y tiene prioridades únicas, acordar unas convenciones para escribir una documentación va en contra de esa condición humana, sin embargo, estamos en la búsqueda de hacer una información usable, no solo por humanos, sino por una futura API (([[http:// | ||
Hay unos niveles principales: | Hay unos niveles principales: | ||
- | Cáda temática contiene siempre un espacio de nombre (namespace) llamado start que funciona | + | Cada temática contiene siempre un espacio de nombre (namespace) llamado |
- | * divulgacion | + | |
- | * practicas | + | |
- | * rutinas | + | |
- | * profundizacion | + | |
- | * investigacion | + | |
+ | |||
+ | Nota: Los namespaces (textos de la url) van sin tildes y en minúsculas, | ||
+ | |||
+ | Nota 2: Tener en cuenta escribir las actividades que se proponen en infinitivo. | ||
+ | ---- | ||
+ | ===== start ===== | ||
+ | Es el documento de llegada y debe darle opciones al navegante, de ser necesario puede ir acompañado de un corto párrafo de contextualización. | ||
+ | |||
+ | ===== divulgacion ===== | ||
+ | Es un texto que puede ser comprendido por alguien que nunca ha conocido la temática, se extiende máximo en dos páginas, introduce al lector con los tres aspectos principales de la temática, contiene anécdotas, datos insólitos, opiniones, es de lectura liviana. | ||
+ | Para encontrar los tres aspectos que pueden servir en este texto nos podemos preguntar lo siguiente " | ||
+ | |||
+ | ===== practicas ===== | ||
+ | Serie de ejercicios para quien ya sabe algo y quiere aprender practicando con retos, Las prácticas deben ir organizadas según los [[aprendizaje: | ||
+ | |||
+ | ===== rutinas ===== | ||
+ | Para alguien que domina el tema y quiere tener rutinas de estudio diarias para elevar su nivel. También deben ir organizadas según los [[aprendizaje: | ||
+ | |||
+ | ===== herramientas ===== | ||
+ | Colección de atajos, hojas de pastel, links de referencia, documentación de referencia rápida, scripts y otro tipo de ayudas para hacer más ágil y/o eficiente las labores con la materia. | ||
+ | |||
+ | ===== ciclos ===== | ||
+ | Desarrollo de la temática basada en ciclos | ||
+ | |||
+ | |||
desarrollo/convenciones/start.1420225412.txt.gz · Última modificación: 2020/02/11 17:17 (editor externo)