feat(docs): agregar estructura de documentación y contenido (docs/, templates/, metadata_json/)

Author: pixelead0

docs/about.md

@@ -0,0 +1,283 @@
+# Acerca de Python CDMX 🐍
+
+## 🎯 Nuestra Misión
+
+Python CDMX es una comunidad apasionada de desarrolladores Python en la Ciudad de México. Nos reunimos mensualmente para compartir conocimiento, experiencias y aprender juntos sobre el lenguaje de programación Python y tecnologías relacionadas.
+
+### Objetivos
+
+- **Conectar desarrolladores** Python de diferentes niveles y experiencias
+- **Compartir conocimiento** a través de charlas técnicas y talleres
+- **Promover mejores prácticas** en el desarrollo con Python
+- **Fomentar la colaboración** y el networking entre miembros
+- **Contribuir al ecosistema** Python en México
+
+---
+
+## 📅 Historia de la Comunidad
+
+### 2023 - El Inicio
+- **5 meetups** realizados
+- **Temas principales:** GitOps, Python History, Jupyter, AWS AI
+- **Ponentes destacados:** Gustavo Vera, Carlos Reyes, David Sol
+
+### 2024 - Crecimiento
+- **12 meetups** completados
+- **Temas principales:** AI, Web Development, DevOps, Data Science
+- **Ponentes destacados:** Gustavo Vera, David Sol, Alejandro López
+
+### 2025 - Expansión
+- **6 meetups** programados
+- **Temas principales:** AI, Open Source, Web Development
+- **Eventos especiales:** Colaboración con UNAM
+
+---
+
+## 🏢 Lugares de Eventos
+
+### Wizeline México
+**Dirección:** Torre Diana, Piso 32, CDMX
+**Horario:** 18:30 - 21:00
+**Networking:** Incluido en cada evento
+
+### UNAM Facultad de Ciencias
+**Dirección:** Anfiteatro Alfredo Barrera
+**Horario:** 16:00 - 19:00
+**Eventos:** Especiales y colaboraciones
+
+---
+
+## 👥 Organizadores
+
+<div class="organizers">
+
+### David Sol
+**Rol:** Organizador Principal
+**Especialidad:** DevOps, Cloud, Python
+**Empresa:** Wizeline
+**GitHub:** [@SolDavidCloud](https://github.com/SolDavidCloud)
+
+### Gustavo Vera
+**Rol:** Organizador y Ponente Frecuente
+**Especialidad:** Python, Web Development, AI
+**Charlas:** 4+ presentaciones
+**GitHub:** [@gvera](https://github.com/gvera)
+
+### Alejandro López
+**Rol:** Organizador y Ponente
+**Especialidad:** Web Development, APIs
+**Charlas:** 2+ presentaciones
+**GitHub:** [@CoffeeQ29kZQo](https://github.com/CoffeeQ29kZQo)
+
+</div>
+
+---
+
+## 📊 Estadísticas de la Comunidad
+
+<div class="community-stats">
+
+### Participación
+- **Total meetups:** 23+ (2023-2025)
+- **Ponentes únicos:** 15+
+- **Asistentes promedio:** 30-50 por meetup
+- **Videos disponibles:** 20+
+
+### Temas Más Populares
+1. **AI & Machine Learning** - 8 charlas
+2. **Web Development** - 6 charlas
+3. **DevOps & Cloud** - 5 charlas
+4. **Data Science** - 4 charlas
+5. **Open Source** - 4 charlas
+
+### Ponentes Más Activos
+1. **Gustavo Vera** - 4 charlas
+2. **David Sol** - 3 charlas
+3. **Alejandro López** - 2 charlas
+4. **Carlos Reyes** - 2 charlas
+
+</div>
+
+---
+
+## 🎤 Formato de los Meetups
+
+### Estructura Típica
+- **18:00 - 18:30** Registro y Networking
+- **18:30 - 18:45** Bienvenida y Presentaciones
+- **18:45 - 19:30** Charla Principal (20-30 min)
+- **19:30 - 20:00** Q&A y Discusión
+- **20:00 - 21:00** Networking y Socialización
+
+### Tipos de Contenido
+- **Charlas técnicas** sobre Python y tecnologías relacionadas
+- **Talleres prácticos** con ejemplos de código real
+- **Lightning talks** de 5-10 minutos
+- **Panel de discusión** sobre temas de interés
+- **Show & Tell** de proyectos personales
+
+---
+
+## 🤝 Colaboraciones
+
+### Wizeline México
+- **Hospedaje** de meetups regulares
+- **Apoyo logístico** y técnico
+- **Networking** con profesionales de la industria
+
+### UNAM Facultad de Ciencias
+- **Eventos especiales** en colaboración
+- **Alcance** a estudiantes universitarios
+- **Recursos académicos** y espacios
+
+### Otras Comunidades
+- **Sudo Ciencias** - Eventos conjuntos
+- **Python México** - Red nacional
+- **GDG México** - Colaboraciones técnicas
+
+---
+
+## 🎯 Valores de la Comunidad
+
+### Inclusividad
+- **Todos los niveles** son bienvenidos (principiantes a expertos)
+- **Diversidad** de perspectivas y experiencias
+- **Ambiente seguro** y respetuoso
+
+### Aprendizaje Continuo
+- **Compartir conocimiento** es fundamental
+- **Preguntas** siempre son bienvenidas
+- **Experimentación** y exploración de nuevas tecnologías
+
+### Colaboración
+- **Proyectos conjuntos** entre miembros
+- **Mentoría** y apoyo mutuo
+- **Contribución** al ecosistema Python
+
+---
+
+## 📱 Canales de Comunicación
+
+<div class="communication-channels">
+
+### Telegram
+**Grupo principal:** [@PythonCDMX](https://t.me/PythonCDMX)
+**Actividad:** Diaria
+**Contenido:** Anuncios, preguntas, recursos
+
+### Meetup
+**Página oficial:** [Python Mexico](https://www.meetup.com/python-mexico)
+**Eventos:** Registro y RSVP
+**Historial:** Todos los meetups pasados
+
+### YouTube
+**Canal:** [@PythonMexico](https://www.youtube.com/@PythonMexico)
+**Contenido:** Transmisiones en vivo y grabaciones
+**Frecuencia:** Mensual
+
+### GitHub
+**Organización:** [python-cdmx](https://github.com/python-cdmx)
+**Proyectos:** Código, recursos, documentación
+
+</div>
+
+---
+
+## 🎁 Cómo Contribuir
+
+### Dar una Charla
+¿Tienes algo interesante que compartir? ¡Nos encantaría escucharte!
+
+**Proceso:**
+1. Contacta con nosotros por [Telegram](https://t.me/PythonCDMX)
+2. Propones tu tema y descripción
+3. Coordinamos fecha y detalles
+4. ¡Presentas tu charla!
+
+**Requisitos:**
+- Conocimiento de Python (cualquier nivel)
+- Ganas de compartir y aprender
+- 20-30 minutos de presentación
+- Opcional: slides o demo
+
+### Organizar Eventos
+- **Ayudar con logística** de meetups
+- **Coordinar ponentes** y temas
+- **Promover eventos** en redes sociales
+- **Documentar** charlas y recursos
+
+### Contribuir al Sitio Web
+- **Mejorar documentación** de meetups
+- **Agregar funcionalidades** al sitio
+- **Traducir contenido** si es necesario
+- **Reportar bugs** o sugerir mejoras
+
+---
+
+## 📚 Recursos de la Comunidad
+
+### Documentación
+- **Este sitio web** - Documentación completa de meetups
+- **Slides y código** - Recursos compartidos por ponentes
+- **Guías y tutoriales** - Contenido educativo
+
+### Proyectos
+- **Repositorios** de código de ejemplo
+- **Templates** para presentaciones
+- **Herramientas** desarrolladas por la comunidad
+
+### Redes
+- **LinkedIn** - Conexiones profesionales
+- **Twitter** - Noticias y actualizaciones
+- **Discord** - Chat en tiempo real (futuro)
+
+---
+
+## 🏆 Reconocimientos
+
+### Ponentes Destacados
+- **Gustavo Vera** - Mayor número de charlas
+- **David Sol** - Organización y contenido técnico
+- **Alejandro López** - Web development y APIs
+
+### Eventos Especiales
+- **Colaboración UNAM** - Abril 2025
+- **Primera charla en inglés** - Julio 2024
+- **Evento híbrido** - Noviembre 2024
+
+---
+
+## 🔮 Visión de Futuro
+
+### Metas 2025-2026
+- **Expandir audiencia** a más desarrolladores
+- **Colaboraciones** con universidades
+- **Eventos especializados** (AI, Web, Data)
+- **Hackathons** y competencias
+
+### Metas a Largo Plazo
+- **Conferencia anual** Python CDMX
+- **Capítulos** en otras ciudades
+- **Programa de mentoría** formal
+- **Contribución** a proyectos open source
+
+---
+
+## 📞 Contacto
+
+### Organizadores
+- **Telegram:** [@PythonCDMX](https://t.me/PythonCDMX)
+- **Email:** pythoncdmx@gmail.com
+- **GitHub:** [python-cdmx](https://github.com/python-cdmx)
+
+### Para Empresas
+¿Te interesa patrocinar o colaborar con la comunidad?
+
+- **Hospedar meetups** en tus oficinas
+- **Proporcionar ponentes** técnicos
+- **Patrocinar eventos** especiales
+- **Ofrecer oportunidades** de empleo
+
+---
+
+*Última actualización: {{ git_revision_date_localized }}*

docs/components/README.md

@@ -0,0 +1,76 @@
+# Componentes Comunes para Meetups
+
+Este directorio contiene componentes reutilizables para las páginas de meetups.
+
+## 📁 Archivos disponibles
+
+### `networking.md`
+Sección de networking que se incluye al final de cada meetup.
+
+### `community-links.md`
+Enlaces a las redes sociales y plataformas de la comunidad.
+
+### `footer.md`
+Footer común con información de última actualización.
+
+## 🎯 Beneficios
+
+- **Mantenimiento centralizado**: Cambios en un solo lugar se reflejan en todos los meetups
+- **Consistencia**: Todos los eventos tienen el mismo estilo y estructura
+- **Reutilización**: No hay que duplicar código
+- **Facilidad de actualización**: Modificar enlaces o estilos es más sencillo
+
+## 📝 Cómo usar los componentes
+
+Actualmente los componentes están embebidos directamente en los archivos de meetups para evitar problemas con el plugin de snippets.
+
+### Ejemplo de uso:
+
+```markdown
+## Contenido específico del meetup...
+
+<!-- Sección de networking embebida -->
+<div class="networking-section" style="background: linear-gradient(135deg, #28a745 0%, #20c997 100%); color: white; padding: 2rem; border-radius: 16px; margin: 2rem 0; text-align: center; box-shadow: 0 8px 32px rgba(40, 167, 69, 0.3);">
+  <h3 style="margin: 0 0 1rem 0; font-size: 1.5rem;">💬 ¡Conecta con la comunidad!</h3>
+  <p style="margin: 0; font-size: 1.1rem; line-height: 1.6;">
+    Después de la charla habrá un tiempo de networking donde podrás platicar con programadores de diferentes niveles e intereses.
+  </p>
+</div>
+
+<!-- Enlaces de la comunidad embebidos -->
+<div class="community-links" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin: 2rem 0;">
+  <a href="https://t.me/PythonCDMX" style="background: #0088cc; color: white; padding: 1rem; border-radius: 12px; text-decoration: none; text-align: center; font-weight: 600; transition: all 0.3s ease; display: flex; align-items: center; justify-content: center; gap: 0.5rem;">
+    📱 Telegram
+  </a>
+  <!-- Más enlaces... -->
+</div>
+```
+
+## 🔧 Modificaciones
+
+Si necesitas modificar algún componente:
+
+1. Edita el archivo correspondiente en este directorio
+2. Copia el contenido actualizado a los meetups que lo usen
+3. Mantén la consistencia visual y de estilo
+
+## 🗂️ Estructura de directorios
+
+```
+docs/
+├── components/
+│   ├── networking.md
+│   ├── community-links.md
+│   ├── footer.md
+│   └── README.md
+├── meetups/
+│   ├── 2025/
+│   │   ├── 202506-junio.md
+│   │   └── ...
+│   └── ...
+└── ...
+```
+
+## ⚠️ Nota importante
+
+Los componentes están embebidos directamente en los archivos de meetups para evitar problemas con el plugin `pymdownx.snippets`. Esto asegura que el sitio funcione correctamente sin errores de compilación.

docs/components/community-links.md

@@ -0,0 +1,16 @@
+## 🔗 Enlaces de la Comunidad
+
+<div class="community-links" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin: 2rem 0;">
+    <a href="https://t.me/PythonCDMX" style="background: #0088cc; color: white; padding: 1rem; border-radius: 12px; text-decoration: none; text-align: center; font-weight: 600; transition: all 0.3s ease; display: flex; align-items: center; justify-content: center; gap: 0.5rem;">
+        📱 Telegram
+    </a>
+    <a href="https://www.meetup.com/python-mexico" style="background: #e51937; color: white; padding: 1rem; border-radius: 12px; text-decoration: none; text-align: center; font-weight: 600; transition: all 0.3s ease; display: flex; align-items: center; justify-content: center; gap: 0.5rem;">
+        📅 Meetup
+    </a>
+    <a href="https://www.youtube.com/@PythonMexico" style="background: #ff0000; color: white; padding: 1rem; border-radius: 12px; text-decoration: none; text-align: center; font-weight: 600; transition: all 0.3s ease; display: flex; align-items: center; justify-content: center; gap: 0.5rem;">
+        🎥 YouTube
+    </a>
+    <a href="https://github.com/python-cdmx" style="background: #333; color: white; padding: 1rem; border-radius: 12px; text-decoration: none; text-align: center; font-weight: 600; transition: all 0.3s ease; display: flex; align-items: center; justify-content: center; gap: 0.5rem;">
+        💻 GitHub
+    </a>
+</div>

docs/components/footer.md

@@ -0,0 +1,7 @@
+---
+
+<div style="text-align: center; margin-top: 3rem; padding: 2rem; background: #f8f9fa; border-radius: 12px;">
+    <p style="margin: 0; color: #6c757d; font-style: italic;">
+        *Última actualización: {{ git_revision_date_localized }}*
+    </p>
+</div>

docs/components/networking.md

@@ -0,0 +1,9 @@
+## 🤝 Networking
+
+<div class="networking-section" style="background: linear-gradient(135deg, #28a745 0%, #20c997 100%); color: white; padding: 2rem; border-radius: 16px; margin: 2rem 0; text-align: center; box-shadow: 0 8px 32px rgba(40, 167, 69, 0.3);">
+    <h3 style="margin: 0 0 1rem 0; font-size: 1.5rem;">💬 ¡Conecta con la comunidad!</h3>
+    <p style="margin: 0; font-size: 1.1rem; line-height: 1.6;">
+        Después de la charla habrá un tiempo de networking donde podrás platicar con programadores de diferentes niveles e intereses.
+        ¡Es la oportunidad perfecta para hacer conexiones profesionales y aprender de otros desarrolladores!
+    </p>
+</div>