Repository navigation
ar 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 أبدًا. اختبر على جهاز حقيقي مُجذَّر (rooted).
- أبقِ التعليقات خارج الكود؛ فالأسماء تشرح المقصد. والترويسة الوحيدة هي راية الترخيص في أعلى كل ملف مصدري.
- طابِق الأسلوب القائم وأبقِ التغييرات مركّزة.
بالمساهمة، فأنت توافق على أن مساهمتك مرخّصة بموجب GNU AGPL-3.0-or-later الخاص بالمشروع.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.