Contribuir a Umbral

Antes de empezar

Para cambios grandes, abre primero una propuesta con el problema y el resultado esperado. No hace falta escribir código para ayudar: también sirven reportes claros, traducciones, documentación y pruebas en otras plataformas.

Fuentes y compilación

Trabaja desde la raíz del repo de Umbral. engine/ es un repositorio generado distinto; no lo trates como origen. Los cambios del navegador deben vivir en src/, prefs/, configs/, locales/, surfer.json y sus parches. Preserva los symlinks y registra recursos nuevos según el empaquetado existente.

Para un checkout nuevo preparado con los requisitos de Mozilla y del proyecto, el flujo usa npm ci y npm run init antes de compilar. En un árbol ya inicializado, importa y compila los cambios actuales. No actualices la base fijada como efecto secundario de una tarea de interfaz.

npm run import
MOZ_PURGE_CACHES=1 npm run build:ui
git diff --check

Qué debe traer una propuesta de cambio

Describe el problema, el comportamiento final, las pruebas ejecutadas y sus límites. Usa perfiles temporales para pruebas; no adjuntes perfiles personales. Distingue compilación, inspección estática y verificación real. Las pruebas deben comprobar comportamiento, no repetir la implementación.

Créditos y alcance

Mantén los avisos de licencia y atribución. No elimines créditos ni renombres globalmente referencias técnicas de Zen o Firefox. Para correcciones de seguridad, usa el canal privado en vez de un PR público con detalles explotables.