Contribueix a Umbral

Abans de començar

Per a canvis grans, obre primer una proposta amb el problema i el resultat esperat. No cal escriure codi per ajudar: també serveixen informes clars, traduccions, documentació i proves en altres plataformes.

Fonts i compilació

Treballa des de l’arrel del repo d’Umbral. engine/ és un repositori generat diferent; no el tractis com a origen. Els canvis del navegador han de viure a src/, prefs/, configs/, locales/, surfer.json i els seus pedaços. Preserva els symlinks i registra els recursos nous segons l’empaquetament existent.

Per a un checkout nou amb els requisits de Mozilla i del projecte preparats, utilitza npm ci i npm run init abans de compilar. En un arbre inicialitzat, importa i compila els canvis actuals. No actualitzis la base fixada com a efecte secundari d’una tasca d’interfície.

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

Què ha d’incloure una proposta de canvi

Descriu el problema, el comportament final, les proves executades i els límits. Utilitza perfils temporals; no hi adjuntis perfils personals. Distingeix compilació, inspecció estàtica i verificació real. Les proves han de comprovar comportament, no repetir la implementació.

Crèdits i abast

Mantén els avisos de llicència i atribució. No eliminis crèdits ni canviïs globalment referències tècniques de Zen o Firefox. Per a correccions de seguretat, utilitza el canal privat en lloc d’un PR públic amb detalls explotables.