Protocolo de Publicación
Guía de formatos, plantillas y estructura recomendada para contribuir a la comunidad.
WORK (PROYECTO)
El Portafolio Oficial
Un Work es un proyecto completo, pulido y finalizado. Es tu carta de presentación profesional donde muestras la arquitectura, el diseño y el impacto de tu solución.
Cómo construir un Work de Alto Valor:
Un Work no es solo mostrar código, es contar la historia de un producto. Debe reflejar profesionalidad y capacidad de resolución de problemas.
- Paso 1: El Gancho (TL;DR): En los primeros 5 segundos el lector debe saber qué se construyó, qué tecnologías clave usaste y por qué importa. Un buen resumen ejecutivo atrae miradas.
- Paso 2: Profundidad del Reto: Describe el "villano" de tu historia técnica. ¿Por qué era difícil este proyecto? ¿Qué limitaciones de tiempo o recursos tenías? Plantea la necesidad real.
- Paso 3: Arquitectura Limpia: Muestra cómo pensaste la solución antes de escribir la primera línea de código. Explica por qué elegiste el stack tecnológico. Usa diagramas (puedes crearlos directamente en el editor) si es posible.
- Paso 4: Código Clave: Nunca pegues archivos enteros. Muestra solo las funciones, configuraciones o algoritmos exactos donde ocurrió la "magia". Explica cada bloque.
- Paso 5: Impacto Real y Resultados: Cierra con métricas. ¿Mejoró el rendimiento un 40%? ¿Aceleró el proceso de otros devs? Añade una sección de próximas mejoras o lecciones aprendidas.
Tono ideal: Profesional, analítico y orientado a resultados. Es una lectura que un Technical Lead valoraría.
GUIDE (MANUAL)
Transferencia de Conocimiento
Una Guide es un tutorial paso a paso. Su objetivo es enseñar a otros desarrolladores cómo construir o configurar algo de principio a fin, con explicaciones claras.
LOG (NOTA DE CAMPO)
El Diario de Ingeniería
Un Field Log es una nota rápida, un bug superado, un snippet útil, o una reflexión técnica. Es el equivalente a las notas adhesivas en tu monitor. No necesita estar pulido.