Escribiendo Artículos sobre Instrucciones de las Tareas

En algunas ocasiones hemos tenido que trabajar en tareas con información desconocida para nosotros ya que no habíamos hecho algo similar antes, para estas tareas deberíamos crear una publicación que funcione como recurso explicativo exponiendo todo lo que tuvimos que encarar y aprender para poder completarla, las decisiones que tomamos, y un vistazo básico de cómo se realizó el cambio; todo esto serviría en un futuro como referencia. Estas publicaciones deberían ser consideradas como "documentos activos", lo que significa que comenzarán con una pequeña cantidad de información y con el tiempo se editará añadiendo detalles o aportes de otros desarrolladores. Qué debería estar escrito en el documento: Los documentos se dividirán en cinco secciones mencionadas a continuación: Resumen de la tarea explicando cuál es el objetivo. Debe ser un texto muy conciso, para que el usuario pueda identificarlo fácilmente y comenzar a leer la solución. Desafíos o preguntas iniciales que fueron significativas, es decir, no sólo preguntas pequeñas, sino las más importantes en cuanto al enfoque adecuado, o cosas relacionadas con la arquitectura en general. Información acerca de los bugs que surgieron, o cualquier cosa que fue inesperada, para que así esto sea tomado como referencia en un futuro. Preguntas que surgieron en el transcurso de la tarea. Las preguntas se pueden colocar en esta sección y luego ser respondidas en la siguiente con código. Fragmentos de código ; estos deberían añadirse siempre que sea posible, para que los puntos a enseñar sean más claros. El fin de estas publicaciones es que sean usadas como tutorial, así que al escribirlo debemos pensar en qué información necesitará el usuario para solventar su duda o problema.