Guía de documentación y estructuración en Google Drive
¿Qué debería estar en Google Drive?
En Google Drive sólo se deberían alojar documentos cuyo formato no puede ser traducido a Markdown (Documentos para el socio, plantillas con el formato de Code&Co, entre otros documentos), además de documentos que sean poco estables como: Spreadsheets, planes de trabajo/proyecto, etcétera.
También se debe tener en cuenta el tema del documento que se subirá a Drive. Es importante para mantener la organización de las carpetas de Code&Co.
Todos los documentos de Drive deben cumplir con el formato oficial.
Carpeta departamental
La carpeta departamental de Drive contiene las siguientes carpetas principales:
- Acuerdos: se refiere a todos los acuerdos que tenemos entre el departamento y con stakeholders (socios formadores, profesores, etc), además de todo lo relacionado a Ética.
- Asistencia: contiene el pase de lista de Code&Co.
- Departamental: se refiere al proyecto departamental y todo lo que implica.
- Docusaurus: contiene todos los documentos que deberían implementarse dentro de Docusaurus y no dentro de Drive.
- Juntas: contiene las reuniones departamentales que se imparten.
- Plantillas: hace referencia a los documentos base para ser editados y mantener un mismo estilo.
- Proyectos: en esta carpeta se encuentran los 3 proyectos (Text&Lines, Technebrios, Tractech). Su organización es altamente dependiente en el equipo encargado del proyecto.
- Recursos: contiene información miscelánea que puede ser de utilidad para cualquier integrante del departamento.
- Reportes de estado: contiene las presentaciones y grabaciones de nuestros reportes de estado semanales.
La estructura de estas carpetas es la siguiente:
📂 502 Code & Co
├─ 📂 Acuerdos
│ └── 📜Todos los archivos de acuerdos departamentales
├─ 📂 Asistencia
│ └── 📜Registro de asistencias
├─ 📂 Departamental
│ ├── 📂Auditorías
│ │⠀⠀⠀└── 📜Registro de auditorías
│ ├── 📂Checklist
│ │⠀⠀⠀└── 📜Checklists
│ ├── 📂CMMI
│ │⠀⠀⠀└── 📜Recursos del CMMI
│ ├── 📂Información Colaboradores
│ │⠀⠀⠀└── 📜Información de los miembros del departamento
│ ├── 📂Plan de proyecto Departamental
│ │⠀⠀⠀└── 📜Planes
│ ├── 📂PM
│ │⠀⠀⠀└── 📜Recursos de PM
│ ├── 📂Presentaciones
│ │⠀⠀⠀└── 📜Presentaciones del departamento
│ └── 📂RH
│ ⠀⠀⠀⠀└── 📜Bitácoras de compromiso
│ ⠀⠀⠀⠀└── 📜Encuestas
│ ⠀⠀⠀⠀└── 📜Información general del departamento
├─ 📂 Docusaurus
│ └── 📜Archivos de Docusaurus
├─ 📂 Juntas
│ └── 📜Registro de Dailys/juntas departamentales
├─ 📂 Plantillas
│ └── 📜Plantillas para documentos
├─ 📂 Proyectos
│ └── 📂Carpetas de cada proyecto de Code&Co
├─ 📂 Recursos
│ └── 📜Recursos para fomentar nuestro aprendizaje
├─ 📂 Reportes de estado
│ └── 📂Contenido de reportes de estado
Carpetas de proyectos
Cada carpeta de proyecto debe incluir las siguientes subcarpetas:
📂 Proyecto
├─ 📂 Acuerdos
│ └── 📜Compromiso
│ └── 📜Trabajo
│ └── 📜Visión del proyecto
│ └── 📜Alcance del proyecto (especificación de requerimientos)
│ └── 📜Cualquier otro que aplique
├─ 📂 Arquitectura
│ └── 📜Diagramas
│ └── 📜Plan de adquisición de infraestructura
│ └── 📜Matriz de conocimientos técnicos
│ └── 📜Planes de capacitación de tecnologías
│ └── 📜Pruebas de arquitectura
│ └── 📜Cualquier otro que aplique
├─ 📂 Juntas
│ └── 📜Dailys
│ └── 📜Juntas de equipo
│ └── 📜Juntas con el socio formador
├─ 📂 Logs
│ └── 📜Defect Log
│ └── 📜Time Log
├─ 📂 Notas
│ └── 📜Información general del proyecto
│ └── 📜Cualquier otro que aplique
├─ 📂 Planes
│ └── 📜Plan de pruebas (plan de calidad)
│ └── 📜Plan de entregas
│ └── 📜Plan de comunicación
│ └── 📜Plan de proyecto
│ └── 📜Plan de trabajo (WoW)
│ └── 📜Plan de valor ganado
│ └── 📜Plan de gestión de riesgos
│ └── 📜Plan de recursos
│ └── 📜Cualquier otro que aplique
├─ 📂 Pruebas
│ └── 📜Unitarias
│ └── 📜Volumen
│ └── 📜Integración
│ └── 📜Heurísticas
│ └── 📜Rendimiento
│ └── 📜Estrés
│ └── 📜Cualquier otro que aplique
├─ 📂 Requerimientos
│ └── 📜Matriz de requisitos
│ └── 📜Reporte de inconsistencia
│ └── 📜Gestión de cambio de requisitos
│ └── 📜Aprobaciones
│ └── 📜Priorizaciones
│ └── 📜Cualquier otro que aplique
├─ 📂 Stakeholders
│ └── 📜Documentos proporcionados por el socio formador
│ └── 📜Matriz de involucramiento
│ └── 📜Cualquier otro que aplique
├─ 📂 Checklist
│ └── 📂Contenido de Checklist de diseño
│ └── 📂Contenido de Checklist de análisis
Historial de cambios
Tipo de versión | Descripción | Fecha | Colaborador |
---|---|---|---|
1.0 | Creación de la guía. | Diego Fuentes Juvera | |
2.0 | Completa modificación del documento. | 24/04/2025 | Juan Pablo Chávez |
3.0 | Implementar estructura de carpetas. | 27/03/2025 | Max Toscano |
3.1 | Corregir formato y agregar información. | 28/03/2025 | Max Toscano |
3.2 | Gestión de configuración. | 24/04/2025 | Diego Fuentes |
3.3 | Implementar acciones correctivas. | 26/04/2025 | Max Toscano |
3.4 | Actualización de las carpetas. | 30/05/2025 | Hiram Mendoza |
3.5 | Implementar acciones correctivas. | 05/06/2025 | Max Toscano |