Contributing ar

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

المساهمة في docxi

نرحب ببلاغات الأخطاء والإصلاحات والتوثيق والترجمات. تشرح هذه الصفحة كيفية الإبلاغ عن مشكلة وما يحتاج إليه طلب السحب (pull request). لإعداد نسخة عمل، راجع إعداد بيئة التطوير.

الإبلاغ عن خطأ

افتح بلاغًا (issue) على github.com/hammad417/docxi/issues يتضمن:

• سكربت Ruby قصيرًا يعيد إنتاج المشكلة
• إصدارات Ruby وdocxi وnokogiri وrubyzip (وRails إن كنت تستخدمه)
• ما توقعته وما حصلت عليه. وفي حالة المستندات التالفة، اذكر البرنامج الذي فتحتها به

أبلغ عن المشكلات الأمنية بشكل خاص بدلًا من ذلك. راجع الأمان.

طلبات السحب

1. انسخ المستودع (fork) وأنشئ فرعًا.
2. أجرِ التغيير، والتزم بأسلوب الشيفرة المحيطة.
3. أضف الاختبارات أو حدّثها، وشغّل bundle exec rake test.
4. إذا تغيّر XML المولَّد عن قصد، فشغّل bundle exec rake golden واشرح التغيير في طلب السحب. تحمي الملفات المرجعية المخرجات التي يعتمد عليها المستخدمون الحاليون.
5. حدّث CHANGELOG.md والتوثيق إذا تغيّر السلوك.
6. افتح طلب السحب. تشغّل CI الاختبارات على Ruby من 2.5 إلى 4.0 وRails من 5.2 إلى 8.1، وتتحقق من أن LibreOffice يفتح المستندات النموذجية.

التغييرات التي تعدّل المستندات الحالية، مثل الإصلاحات المخطط لها في الإصدار 0.2.0، مكانها طلب سحب مستقل، كي تسهل مراجعة الفروق في الملفات المرجعية.

التوثيق والترجمات

• ملف README الإنجليزي هو مصدر 15 ترجمة في docs/i18n/. اتبع docs/i18n/TRANSLATION_GUIDE.md في المستودع عند تعديله.
• يُكتب هذا الويكي في مجلد wiki/ في المستودع ويُنشر منه، ويشرح wiki/README.md الطريقة.

صفحات ذات صلة

• إعداد بيئة التطوير
• البنية
• خارطة الطريق

---

→ الصفحة الرئيسية للويكي · README