Repository navigation
pl 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 | 中文
Dziękujemy za zainteresowanie VD Google. Wkład jest mile widziany: tłumaczenia, zgłoszenia błędów, dokumentacja i kod.
- VD Google czyta prawdę i nigdy niczego nie fałszuje. Wkład musi to zachować. Prawdziwy wynik negatywny pozostaje negatywny; nieaktualna pamięć podręczna jest oznaczana jako zbuforowana; brakująca wartość to Nieznane. Nie łagodź odczytu, by wyglądał ładniej.
- Prywatność jest absolutna. Aplikacja nie deklaruje żadnych uprawnień, a WebUI nie kontaktuje się z żadnym zdalnym źródłem. Nigdy nie dodawaj uprawnienia, wywołania sieciowego ani niczego, co wysyła dane poza urządzenie.
- Aplikacja i WebUI są identyczne. Każda zmiana tego, co jest pokazywane, lub eksportowanego raportu musi trafić do obu, z tym samym sformułowaniem. Nigdy nie mogą się rozjechać.
-
Etykiety żyją raz, w 21 językach. Każdy tekst widoczny dla użytkownika jest
zdefiniowany dla aplikacji (
res/values*/strings.xml) i dla WebUI (webroot/lang/). Jeśli dodajesz lub zmieniasz etykietę, zaktualizuj wszystkie języki.
Tłumaczenia to najłatwiejszy i najcenniejszy wkład. Readme jest tłumaczone na język
(README.<lang>.md), teksty aplikacji i WebUI na język, a ta dokumentacja pod
docs/<lang>/. Zachowuj spójność terminologii w obrębie języka, dopasuj się do
istniejącego tonu i nigdy nie tłumacz maszynowo terminu technicznego, którego nie jesteś
pewien.
Otwórz zgłoszenie z modelem swojego urządzenia, wersją Androida oraz (jeśli dotyczy odczytu) eksportem (nie zawiera żadnych danych osobowych). Sekcja diagnostyczna eksportu jest stworzona dokładnie do tego.
- Buduj release, nigdy debug. Testuj na prawdziwym, zrootowanym urządzeniu.
- Nie umieszczaj komentarzy w kodzie; nazwy wyjaśniają intencję. Jedynym nagłówkiem jest baner licencyjny na górze każdego pliku źródłowego.
- Dopasuj się do istniejącego stylu i utrzymuj zmiany w jednym temacie.
Współtworząc, zgadzasz się, że twój wkład jest licencjonowany na warunkach projektowej GNU AGPL-3.0-or-later.
Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.