Archivos de comunidad centralizados para toda la organización
Este es el repositorio especial .github de AmoxcalliDev, que contiene los archivos de comunidad y políticas que se aplican automáticamente a todos los repositorios de nuestra organización.
GitHub da un tratamiento especial al repositorio .github en las organizaciones. Los archivos aquí definidos sirven como valores predeterminados para todos los repositorios de AmoxcalliDev que no tengan sus propios archivos específicos.
.github/
├── README.md # Este archivo
├── CODE_OF_CONDUCT.md # Código de conducta
├── CONTRIBUTING.md # Guía de contribución
├── SECURITY.md # Política de seguridad
├── SUPPORT.md # Guía de soporte
├── pull_request_template.md # Template de pull requests
├── .github/ # Carpeta anidada para templates
│ └── ISSUE_TEMPLATE/ # Templates de issues
│ ├── bug_report.yml # Formulario de reporte de bugs
│ ├── bug_report.md # Template markdown de bugs
│ ├── feature_request.yml # Formulario de solicitud de features
│ ├── feature_request.md # Template markdown de features
│ └── config.yml # Configuración de templates
└── profile/
└── README.md # Perfil público de la organización
Define las reglas de convivencia y comportamiento esperado en todos nuestros proyectos.
Se aplica a: Todos los repositorios de AmoxcalliDev
- Estándares de comportamiento profesional
- Proceso de reporte de incidentes
- Consecuencias por violaciones
- Valores de la comunidad
Guía completa sobre cómo contribuir a nuestros proyectos open source.
Incluye:
- Proceso de contribución paso a paso
- Estándares de código y convenciones
- Guía de commits (Conventional Commits)
- Templates para bugs y features
- Mejores prácticas
Política de seguridad y proceso para reportar vulnerabilidades.
Cubre:
- Cómo reportar vulnerabilidades de forma responsable
- Proceso de respuesta y tiempos
- Clasificación de severidad
- Prácticas de seguridad
- Divulgación responsable
Guía sobre dónde y cómo obtener ayuda.
Explica:
- Canales de soporte disponibles
- Cómo reportar bugs correctamente
- Cómo solicitar funcionalidades
- FAQs y recursos de aprendizaje
- Comunidad y valores
Perfil público que se muestra en la página principal de la organización AmoxcalliDev.
GitHub aplica automáticamente estos archivos a cualquier repositorio de AmoxcalliDev que NO tenga su propio archivo:
Ejemplo:
📦 AmoxcalliDev/mi-proyecto
├── src/
└── README.md
✅ Automáticamente usa:
- AmoxcalliDev/.github/CONTRIBUTING.md
- AmoxcalliDev/.github/CODE_OF_CONDUCT.md
- AmoxcalliDev/.github/SECURITY.md
- AmoxcalliDev/.github/SUPPORT.md
Si un repositorio necesita reglas específicas, puede crear su propio archivo:
Ejemplo:
📦 AmoxcalliDev/proyecto-especial
├── CONTRIBUTING.md # ← Archivo local
└── README.md
✅ Usa el archivo local en lugar del de .github
Todos los proyectos siguen las mismas reglas y estándares de la organización.
Actualiza un archivo aquí y aplica automáticamente a todos los repositorios.
No necesitas copiar y pegar los mismos archivos en cada repo.
Los repositorios pueden tener sus propias reglas específicas si es necesario.
Los contribuidores saben qué esperar en cualquier proyecto de AmoxcalliDev.
Al crear un nuevo repositorio, puedes simplemente no crear estos archivos y GitHub los usará automáticamente. O puedes crear un archivo que haga referencia al centralizado:
# Guía de Contribución
Este proyecto sigue la [Guía de Contribución de AmoxcalliDev](https://github.com/AmoxcalliDev/.github/blob/main/CONTRIBUTING.md).
Por favor, lee las guías completas antes de contribuir.Si ya tienes archivos propios, actualízalos para referenciar las guías centralizadas:
# Guía de Contribución
Este proyecto sigue la [Guía de Contribución de AmoxcalliDev](https://github.com/AmoxcalliDev/.github/blob/main/CONTRIBUTING.md).
## Guías Específicas de Este Proyecto
[Aquí agregas reglas específicas si es necesario]Los mantenedores y administradores de la organización AmoxcalliDev.
- Crea una rama desde
main - Realiza los cambios necesarios
- Abre un Pull Request
- Solicita revisión de otros mantenedores
- Una vez aprobado, merge a
main - Los cambios se aplican automáticamente a todos los repos
✅ Mejores prácticas:
- Discute cambios importantes en Discussions primero
- Revisa el impacto en repos existentes
- Documenta bien los cambios
- Comunica actualizaciones importantes a la comunidad
El archivo profile/README.md es especial:
- Se muestra en
github.com/AmoxcalliDev - Es la "cara" pública de la organización
- Presenta quiénes somos y qué hacemos
- Incluye links a recursos importantes
Para preguntas sobre estos archivos de comunidad:
- 💬 Discussions
- 📧 contact@amoxcalli.dev (próximamente)
- 💬 Discord (próximamente)
¿Quieres mejorar nuestros archivos de comunidad?
- Abre una Discussion para proponer cambios
- Lee nuestra Guía de Contribución
- Crea un Pull Request con tus mejoras
- Los mantenedores revisarán y discutirán los cambios
- GitHub Docs: Crear archivos de salud predeterminados
- Guía de Contribución
- Código de Conducta
- Política de Seguridad
- Soporte
Amoxcalli (del náhuatl: Casa de libros, biblioteca) es nuestra organización open source donde compartimos conocimiento y construimos herramientas para la comunidad.
- 🏢 Extensión de ByFruitsDev
- 🌮 Comunidad mexicana de desarrolladores
- 💻 Código abierto y conocimiento compartido
- 🚀 Comprometidos con la excelencia técnica
"El código es mejor cuando se comparte"
💚 Hecho con amor desde México 🇲🇽
