Organización wiki

En está página explicamos como manejamos la información dentro de la wiki de Joko.

= ¿Que es la wiki? = La wiki de Joko es un compendio de recomendaciones y saberes que permiten a un desarrollador moverse mas rápido dentro de un proyecto de desarrollo de software, en especial si es utilizando el framework Joko.

La wiki de Joko no es la documentación de Joko, sino de como hacemos Joko y lo que aprendemos en el proceso.

= ¿Cómo está organizada? = Existen dos tipos de artículos:
 * cheatsheet: Es una guía rápida sobre alguna herramienta. Típicamente incluye referencias.
 * convention: Es una especificación de lo que se espera de un colaborador en un escenario particular. Por ejemplo: convenciones al hacer commit de Git.

Todas las páginas en la wiki deben tener una categoría que indique si es cheatsheet o convention. Además se pueden subclasificar en:


 * Development‏‎: Relacionados con desarrollo de software.
 * HelpDesk: ‏Relacionados con herramientas para un usuario final.
 * Infraestructura‏‎: Relacionados a temas de administración de sistemas y redes.

=Lineamientos para las páginas=

Páginas de Guias y convenciones
La idea es hablarle a la persona que está leyendo, tener un enfoque bien parecido a tutorial. No queremos re-inventar la rueda y volver a crear tutoriales que ya existen. El objetivo es ser una guía para mostrarle al desarrollador donde están los links interesantes, lo que debería de conocer. Siempre debe existir un índice ordenado, que tenga al menos tres niveles. Un ejemplo de lo que se espera es esta misma página.

=Quiero escribir una página? Dónde empiezo?= Un buen punto de partida es la página lo que tengo que saber como developer. Es un índice de todo lo que necesitamos articular de conocimiento en la oficina, sería como la raiz de la wiki.