Repository navigation
fa 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 یکسان‌اند. هر تغییر در آنچه نشان داده می‌شود، یا در گزارش صادرشده، باید در هر دو، با همان واژگان، اعمال شود. آن‌ها هرگز نباید از هم فاصله بگیرند.
-
برچسب‌ها یک بار زندگی می‌کنند، در ۲۱ زبان. هر رشتهٔ روبه‌کاربر برای اپلیکیشن (
res/values*/strings.xml) و WebUI (webroot/lang/) تعریف می‌شود. اگر برچسبی اضافه یا تغییر دادید، همهٔ زبان‌ها را به‌روز کنید.
ترجمه‌ها آسان‌ترین و ارزشمندترین مشارکت‌اند. فایل readme برای هر زبان (README.<lang>.md)، رشته‌های اپلیکیشن و WebUI برای هر زبان، و این مستندات زیر docs/<lang>/ ترجمه می‌شوند. اصطلاحات را درون یک زبان یکدست نگه دارید، لحن موجود را رعایت کنید، و هرگز یک اصطلاح فنی را که از آن مطمئن نیستید ماشینی ترجمه نکنید.
یک issue با مدل دستگاه، نسخهٔ اندروید، و، اگر دربارهٔ یک خوانش است، یک خروجی باز کنید (خروجی هیچ دادهٔ شخصی ندارد). بخش تشخیصِ خروجی دقیقاً برای همین ساخته شده است.
- در حالت release بسازید، هرگز debug. روی یک دستگاه واقعیِ روت‌شده آزمایش کنید.
- توضیحات را از کد بیرون نگه دارید؛ نام‌ها نیت را توضیح می‌دهند. تنها سرآیند، بنر مجوز در بالای هر فایل منبع است.
- سبک موجود را رعایت کنید و تغییرها را متمرکز نگه دارید.
با مشارکت می‌پذیرید که مشارکت شما تحت GNU AGPL-3.0-or-later پروژه منتشر می‌شود.
این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری می‌شود. اصلاحات و بهبودها خوش‌آمد است؛ به CONTRIBUTING.md مراجعه کنید.