Skip to content

Commit bc97414

Browse files
author
pixelead0
committed
docs(community): agregar documentación y guías de comunidad (README.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, CHANGELOG.md)
1 parent 7db305b commit bc97414

File tree

4 files changed

+766
-39
lines changed

4 files changed

+766
-39
lines changed

CHANGELOG.md

Lines changed: 194 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,194 @@
1+
# Changelog 📝
2+
3+
Todos los cambios notables en este proyecto serán documentados en este archivo.
4+
5+
El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/),
6+
y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [Unreleased]
9+
10+
### Added
11+
- Plantillas para issues y pull requests
12+
- Código de conducta de la comunidad
13+
- Política de seguridad
14+
- Guía de contribución detallada
15+
- Archivo CHANGELOG.md
16+
17+
### Changed
18+
- Mejorada la documentación del proyecto
19+
- Actualizado el README con información más completa
20+
21+
### Fixed
22+
- Archivos de configuración para GitHub
23+
24+
## [1.0.0] - 2024-01-XX
25+
26+
### Added
27+
- Sitio web oficial de Python CDMX Charlas
28+
- Documentación completa de meetups desde 2023
29+
- Sistema de búsqueda avanzada
30+
- Tema personalizado con colores de Python CDMX
31+
- Integración con YouTube para videos
32+
- Modo oscuro/claro
33+
- Despliegue automático con GitHub Actions
34+
- Responsive design para todos los dispositivos
35+
- Estadísticas de la comunidad
36+
- Páginas de meetups organizadas por año
37+
- Scripts de migración de datos
38+
- Configuración de MkDocs con Material theme
39+
- Plugins para funcionalidad avanzada
40+
41+
### Features
42+
- **Navegación intuitiva** - Estructura clara y fácil de usar
43+
- **Búsqueda semántica** - Encuentra contenido por tema, ponente o palabras clave
44+
- **Metadatos completos** - Información detallada de cada meetup
45+
- **Enlaces a recursos** - Slides, videos, código y más
46+
- **Información de ponentes** - Biografías y redes sociales
47+
- **Filtros por dificultad** - Principiante, Intermedio, Avanzado
48+
- **Soporte multiidioma** - Charlas en español e inglés
49+
- **Integración social** - Enlaces a Telegram, Meetup, YouTube
50+
- **SEO optimizado** - Mejor visibilidad en buscadores
51+
52+
### Technical
53+
- **MkDocs 1.5.0+** - Generador de documentación estática
54+
- **Material for MkDocs 9.5.0+** - Tema moderno y responsive
55+
- **Git revision date plugin** - Fechas automáticas de actualización
56+
- **Minify plugin** - Optimización de archivos estáticos
57+
- **PyMdown Extensions** - Funcionalidades Markdown avanzadas
58+
- **Jinja2** - Motor de plantillas
59+
- **GitHub Actions** - CI/CD automático
60+
- **GitHub Pages** - Hosting gratuito
61+
62+
### Content
63+
- **23+ meetups documentados** (2023-2025)
64+
- **15+ ponentes únicos**
65+
- **20+ videos disponibles**
66+
- **Múltiples temas** - AI, Web Dev, DevOps, Data Science
67+
- **Lugares de eventos** - Wizeline México, UNAM Facultad de Ciencias
68+
- **Información de contacto** - Telegram, Meetup, redes sociales
69+
70+
## [0.9.0] - 2023-12-XX
71+
72+
### Added
73+
- Estructura inicial del proyecto
74+
- Configuración básica de MkDocs
75+
- Primeros meetups de 2023
76+
- Scripts de generación de contenido
77+
78+
### Changed
79+
- Migración desde formato de texto plano
80+
- Organización de contenido por años
81+
82+
### Fixed
83+
- Problemas de formato en archivos Markdown
84+
- Enlaces rotos en documentación
85+
86+
## [0.8.0] - 2023-11-XX
87+
88+
### Added
89+
- Sistema de metadatos para meetups
90+
- Plantillas para contenido
91+
- Estilos CSS personalizados
92+
93+
### Changed
94+
- Mejorada la estructura de archivos
95+
- Optimizada la navegación
96+
97+
## [0.7.0] - 2023-10-XX
98+
99+
### Added
100+
- Integración con GitHub Pages
101+
- Workflow de despliegue automático
102+
- Configuración de dominio personalizado
103+
104+
### Fixed
105+
- Problemas de compatibilidad con navegadores
106+
- Errores de validación HTML
107+
108+
## [0.6.0] - 2023-09-XX
109+
110+
### Added
111+
- Sistema de búsqueda
112+
- Filtros por tema y dificultad
113+
- Páginas de estadísticas
114+
115+
### Changed
116+
- Rediseño del tema visual
117+
- Mejorada la experiencia móvil
118+
119+
## [0.5.0] - 2023-08-XX
120+
121+
### Added
122+
- Integración con YouTube
123+
- Galería de fotos de eventos
124+
- Información de ponentes
125+
126+
### Changed
127+
- Reorganización de la estructura de contenido
128+
- Mejorada la documentación
129+
130+
## [0.4.0] - 2023-07-XX
131+
132+
### Added
133+
- Páginas de meetups individuales
134+
- Metadatos estructurados
135+
- Enlaces a recursos
136+
137+
### Fixed
138+
- Problemas de navegación
139+
- Errores de formato
140+
141+
## [0.3.0] - 2023-06-XX
142+
143+
### Added
144+
- Configuración de MkDocs
145+
- Tema Material básico
146+
- Primeros archivos de contenido
147+
148+
### Changed
149+
- Migración desde formato anterior
150+
- Estructura de directorios
151+
152+
## [0.2.0] - 2023-05-XX
153+
154+
### Added
155+
- Estructura inicial del proyecto
156+
- Scripts de migración de datos
157+
- Documentación básica
158+
159+
## [0.1.0] - 2023-04-XX
160+
161+
### Added
162+
- Concepto inicial del proyecto
163+
- Recopilación de datos de meetups
164+
- Planificación de estructura
165+
166+
---
167+
168+
## Notas de Versión
169+
170+
### Convenciones de Versionado
171+
172+
- **MAJOR.MINOR.PATCH** - [Semantic Versioning](https://semver.org/)
173+
- **MAJOR** - Cambios incompatibles con versiones anteriores
174+
- **MINOR** - Nuevas funcionalidades compatibles
175+
- **PATCH** - Correcciones de bugs compatibles
176+
177+
### Tipos de Cambios
178+
179+
- **Added** - Nuevas funcionalidades
180+
- **Changed** - Cambios en funcionalidades existentes
181+
- **Deprecated** - Funcionalidades que serán removidas
182+
- **Removed** - Funcionalidades removidas
183+
- **Fixed** - Correcciones de bugs
184+
- **Security** - Mejoras de seguridad
185+
186+
### Contribuir al Changelog
187+
188+
Al hacer cambios al proyecto, actualiza esta sección siguiendo el formato establecido. Para cambios menores, puedes agregar entradas bajo `[Unreleased]`.
189+
190+
---
191+
192+
*Este changelog documenta la evolución del sitio web de Python CDMX Charlas desde su concepción hasta la versión actual.*
193+
194+
**Repositorio:** https://github.com/PythonMexico/python-cdmx-page

CODE_OF_CONDUCT.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Código de Conducta 🤝
2+
3+
## Nuestro Compromiso
4+
5+
En el interés de fomentar un ambiente abierto y acogedor, nosotros como contribuidores y mantenedores nos comprometemos a hacer de la participación en nuestro proyecto y nuestra comunidad una experiencia libre de acoso para todos, sin importar edad, tamaño corporal, discapacidad, etnia, características sexuales, identidad y expresión de género, nivel de experiencia, educación, estatus socioeconómico, nacionalidad, apariencia personal, raza, religión, o identidad y orientación sexual.
6+
7+
## Nuestros Estándares
8+
9+
Ejemplos de comportamiento que contribuyen a crear un ambiente positivo incluyen:
10+
11+
* Usar lenguaje acogedor e inclusivo
12+
* Respetar diferentes puntos de vista y experiencias
13+
* Aceptar graciosamente la crítica constructiva
14+
* Enfocarse en lo que es mejor para la comunidad
15+
* Mostrar empatía hacia otros miembros de la comunidad
16+
17+
Ejemplos de comportamiento inaceptable incluyen:
18+
19+
* El uso de lenguaje o imágenes sexualizadas, o atención o avances sexuales no deseados
20+
* Trolling, comentarios insultantes/despectivos, y ataques personales o políticos
21+
* Acoso público o privado
22+
* Publicar información privada de otros, como direcciones físicas o electrónicas, sin permiso explícito
23+
* Otra conducta que razonablemente podría considerarse inapropiada en un entorno profesional
24+
25+
## Nuestras Responsabilidades
26+
27+
Los mantenedores del proyecto son responsables de aclarar los estándares de comportamiento aceptable y se espera que tomen medidas correctivas apropiadas y justas en respuesta a cualquier caso de comportamiento inaceptable.
28+
29+
Los mantenedores del proyecto tienen el derecho y la responsabilidad de remover, editar, o rechazar comentarios, commits, código, ediciones de wiki, issues, y otras contribuciones que no estén alineadas con este Código de Conducta, y de banear temporal o permanentemente a cualquier contribuidor por otros comportamientos que consideren inapropiados, amenazantes, ofensivos, o dañinos.
30+
31+
## Alcance
32+
33+
Este Código de Conducta aplica tanto en espacios del proyecto como en espacios públicos cuando un individuo está representando al proyecto o su comunidad. Ejemplos de representación del proyecto o comunidad incluyen usar una dirección de email oficial del proyecto, postear a través de una cuenta oficial de redes sociales, o actuar como representante designado en un evento online u offline. La representación del proyecto puede ser definida y aclarada por los mantenedores del proyecto.
34+
35+
## Aplicación
36+
37+
Casos de comportamiento abusivo, acosador, o inaceptable pueden ser reportados contactando al equipo del proyecto en [[email protected]]. Todas las quejas serán revisadas e investigadas y resultarán en una respuesta que se considere necesaria y apropiada a las circunstancias. El equipo del proyecto está obligado a mantener confidencialidad respecto al reportante de un incidente. Más detalles de políticas específicas de aplicación pueden ser posteados por separado.
38+
39+
Mantenedores del proyecto que no sigan o hagan cumplir el Código de Conducta de buena fe pueden enfrentar repercusiones temporales o permanentes según lo determinen otros miembros del liderazgo del proyecto.
40+
41+
## Atribución
42+
43+
Este Código de Conducta es una adaptación del [Contributor Covenant](https://www.contributor-covenant.org), versión 2.0, disponible en https://www.contributor-covenant.org/es/version/2/0/code_of_conduct.html.
44+
45+
Para respuestas a preguntas comunes sobre este código de conducta, vea https://www.contributor-covenant.org/faq
46+
47+
## Contacto
48+
49+
Si tienes preguntas sobre este Código de Conducta, puedes contactarnos:
50+
51+
- **Email:** [email protected]
52+
- **Telegram:** [@PythonCDMX](https://t.me/PythonCDMX)
53+
- **Meetup:** [Python México](https://www.meetup.com/python-mexico)
54+
55+
## Agradecimientos
56+
57+
Gracias a todos los miembros de la comunidad Python CDMX por hacer de este un espacio seguro y acogedor para todos. Juntos construimos una comunidad más fuerte y diversa. 🐍
58+
59+
---
60+
61+
*Última actualización: Enero 2024*

0 commit comments

Comments
 (0)