Repository navigation
ru 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 | 中文
Спасибо за интерес к VD Google. Вклад приветствуется: переводы, сообщения об ошибках, документация и код.
- VD Google читает правду и никогда ничего не подделывает. Ваш вклад должен сохранять это. Настоящий отрицательный результат остаётся отрицательным; устаревший кеш помечается как кешированный; отсутствующее значение: «Неизвестно». Не смягчайте показание, чтобы оно выглядело приятнее.
- Приватность абсолютна. Приложение не объявляет разрешений, а WebUI не обращается ни к какому удалённому источнику. Никогда не добавляйте разрешение, сетевой вызов или что угодно, что отправляет данные за пределы устройства.
- Приложение и WebUI идентичны. Любое изменение в том, что показывается, или в экспортируемом отчёте должно попасть в оба, с одинаковыми формулировками. Они никогда не должны расходиться.
-
Подписи живут один раз, на 21 языке. Каждая строка, видимая пользователю, определена
для приложения (
res/values*/strings.xml) и для WebUI (webroot/lang/). Если вы добавляете или меняете подпись, обновите все языки.
Переводы: самый лёгкий и самый ценный вклад. Файл readme переводится по языкам
(README.<lang>.md), строки приложения и WebUI переводятся по языкам, а эта документация размещается под
docs/<lang>/. Соблюдайте единую терминологию внутри языка, выдерживайте существующий
тон и никогда не переводите машинно технический термин, в котором не уверены.
Откройте issue с указанием модели устройства, версии Android и, если дело в показании, экспорта (он не содержит личных данных). Раздел диагностики в экспорте создан именно для этого.
- Собирайте release, никогда не debug. Тестируйте на реальном устройстве с root.
- Не держите комментарии в коде; имена объясняют замысел. Единственный заголовок: баннер лицензии в начале каждого файла исходного кода.
- Соблюдайте существующий стиль и держите изменения сфокусированными.
Внося вклад, вы соглашаетесь, что ваш вклад лицензируется в соответствии с лицензией проекта GNU AGPL-3.0-or-later.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.