نشكرك على المساهمة في مستندات Bazel. هناك بعض الطرق للمساعدة في إنشاء مستندات أفضل للمنتدى.
أنواع الوثائق
يشمل هذا الموقع الإلكتروني بضعة أنواع من المحتوى.
- المستندات السردية التي كتبها كتّاب تقنيون ومهندسون معظم هذا الموقع الإلكتروني عبارة عن مستندات سردية تغطي الأدلة الإرشادية والمهمة.
- المستندات المرجعية التي يتمّ إنشاؤها من خلال التعليقات على الرموز لا يمكنك إجراء تغييرات على صفحات المستندات المرجعية مباشرةً، ولكن عليك بدلاً من ذلك تغيير مصدرها.
البنية الأساسية للمستندات
يتم عرض مستندات Bazel من Google، ويتم النسخ المطابق لملفات المصدر في مستودع Bazel على GitHub. يمكنك إجراء تغييرات على الملفات المصدر في GitHub. في حال الموافقة، يمكنك دمج التغييرات وسيتولى اختصاصي صيانة Bazel تعديل مصدر الموقع الإلكتروني لنشر التعديلات.
التغييرات الطفيفة
يمكنك التعامل مع التغييرات البسيطة، مثل إصلاح الأخطاء الإملائية أو الأخطاء الإملائية، بعدة طرق.
- طلب السحب. يمكنك إنشاء طلب سحب في GitHub باستخدام المحرّر المستند إلى الويب أو في أحد الفروع.
- خطأ يمكنك الإبلاغ عن الخطأ والتفاصيل والتغييرات المقترحة، وسيتم إجراء التعديلات من قِبل مالكي مستندات Bazel.
التغييرات الكبيرة
إذا أردت إجراء تغييرات كبيرة على المستندات الحالية أو اقتراح مستندات جديدة، يمكنك إنشاء طلب سحب أو البدء باستخدام مستند Google والتواصل مع مالكي Bazel للتعاون في العمل.