Nuestro objetivo es conseguir un trabajo principalmente asíncrono. Esto solo lo podemos conseguir si todos nuestros procesos están perfectamente documentados y actualizados.
Para esto desarrollamos una serie de documentación, principalmente en Notion.
Esta documentación debe ser:
- Lo más concisa posible.
- Útil.
- Actualizada.
- Sin errores de ortografía.
- Sin menciones personales.
- Las menciones deben ser en tercera persona, por departamento o desde la perspectiva de la empresa, Helmcode.
- NO debe contener contenido sexual, insultos ni elementos externos al trabajo.
Aparte de la documentación general. También debemos utilizar los diferentes sistemas de discusión de las diferentes herramientas que utilizamos, por ejemplo:
- GitLab: comentarios en pull requests.
- Holded: foro de discusiones de proyectos o comentarios en tareas.
¿Qué debemos evitar en su mayoría?
- Comunicaciones individuales. Es mejor que expongas tu pregunta en un chat grupal que a alguien específico. Incluso a pesar de que sepas que esa persona va a resolver tu duda.
- Utilizar los chats como foros de discusión para una tarea o proyecto específico.
- Dejar desactualizada una documentación.
- Hacer documentación demasiado extensa.