53 lines (37 loc) · 1.72 KB

Guía de contribución

Gracias por contribuir a MediaWiki Production Lab.

Código de conducta

Adoptamos el Contributor Covenant y esperamos respeto en todas las interacciones. Reporta incidentes a seguridad@example.org.

Requisitos previos

VirtualBox 7+, Vagrant 2.4+
PHP 8.1 con Composer
Node.js 20 + npm
Git y make

Flujo de contribución

Fork del repositorio y crea rama feature (feat/<scope>-<descripcion>).
Asegura que exista un issue vinculado o ADR cuando aplique.
Escribe tests antes del código (TDD: Red → Green → Refactor).
Ejecuta scripts locales (./infrastructure/run-all-tests.sh).
Actualiza documentación y enlaza al índice (docs/INDEX.md).
Abre Pull Request detallando cambios y resultados de pruebas.

Estilo de commits

Usa Conventional Commits con mensajes en español:

feat(instalacion): automatizar verificacion de prerequisitos
fix(db): corregir permisos de replicacion
docs(ops): actualizar runbook de incidentes

Estándares de código y pruebas

PHP: PSR-12 + type hints.
JavaScript: ESLint con configuración del proyecto.
Cobertura mínima 80% (./infrastructure/development/test-extension.sh).
Ejecuta phpcs, phpunit, eslint, markdownlint antes de enviar.

Revisiones y merge

Requiere al menos 2 aprobaciones.
CI debe estar en verde.
Actualiza branch con git rebase antes de merge.
Merge mediante --no-ff para mantener historial claro.

Recursos