Repository navigation
it CONTRIBUTING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Tiếng Việt | 中文
Grazie per il tuo interesse in VD Google. I contributi sono benvenuti: traduzioni, segnalazioni di bug, documentazione e codice.
- VD Google legge la verità e non falsifica mai nulla. I contributi devono mantenerlo tale. Un vero esito negativo resta negativo; una cache obsoleta è etichettata come memorizzata in cache; un valore mancante è Sconosciuto. Non ammorbidire una lettura per farla apparire più gradevole.
- La privacy è assoluta. L'app non dichiara alcun permesso e la WebUI non contatta alcuna origine remota. Non aggiungere mai un permesso, una chiamata di rete o qualunque cosa che invii dati fuori dal dispositivo.
- L'app e la WebUI sono identiche. Qualsiasi modifica a ciò che viene mostrato, o al report esportato, deve approdare in entrambe, con la stessa formulazione. Non devono mai divergere.
-
Le etichette vivono una sola volta, in 21 lingue. Ogni stringa rivolta all'utente è
definita per l'app (
res/values*/strings.xml) e per la WebUI (webroot/lang/). Se aggiungi o modifichi un'etichetta, aggiorna tutte le lingue.
Le traduzioni sono il contributo più semplice e prezioso. Il readme è tradotto per lingua
(README.<lang>.md), le stringhe dell'app e della WebUI per lingua, e questa documentazione
sotto docs/<lang>/. Mantieni la terminologia coerente all'interno di una lingua, rispetta
il tono esistente e non tradurre mai automaticamente un termine tecnico di cui non sei sicuro.
Apri una issue con il modello del tuo dispositivo, la versione di Android e, se riguarda una lettura, un'esportazione (non contiene dati personali). La sezione diagnostica dell'esportazione è costruita esattamente per questo.
- Compila in release, mai in debug. Testa su un dispositivo reale con root.
- Tieni i commenti fuori dal codice; i nomi spiegano l'intento. L'unica intestazione è il banner della licenza in cima a ogni file sorgente.
- Rispetta lo stile esistente e mantieni le modifiche mirate.
Contribuendo, accetti che il tuo contributo sia rilasciato sotto la GNU AGPL-3.0-or-later del progetto.
Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.