مراجعة الوثائق باستخدام مشكلات GitHub
إحدى الطرق الأكثر فائدة للمساهمة في Microsoft Learn هي تقديم ملاحظات مباشرة حول مقالة وثائق. باستخدام ارتباط الملاحظات على الصفحة، يمكنك توفير عمليات تحرير أو اقتراحات أو أسئلة أو رؤى أخرى عند ظهورها في الاستعراض. نظرا لأنه يتم تخزين معظم محتوى وثائق Microsoft Learn في مستودعات GitHub، يمكنك تقديم ملاحظاتك باستخدام عملية GitHub تسمى إرسال مشكلة GitHub.
المشكلة في GitHub هي أداة تمكن مستخدمي التكنولوجيا والمهندسين وزوار Microsoft Learn الآخرين من مشاركة الملاحظات وتعقبها في مقالة معينة. يمكنك ملء نموذج لتوثيق ملاحظاتك ونشرها في مستودع المقالة المصدر في GitHub، حيث سيتم إعلام الكاتب أو المالك. يمكن لأي شخص يزور مستودع GitHub رؤية المشكلات. وهي بمثابة طريقة مفيدة لجمع الملاحظات القيمة وتخزينها، مثل الإبلاغ عن الأخطاء أو طلبات الميزات أو الملاحظات.
لماذا مراجعة المحتوى في GitHub؟
يعد تقديم مراجعات المحتوى على GitHub طريقة مباشرة للمساهمة في موضوع تعشقه أو تعرفه. وهذا يعني أنه يمكنك إضافة أفكارك أثناء استكشاف موضوع في وثائق Microsoft. يساعد المساهمة بأفكارك في مجموعة المعارف على تحسين تجارب منتجات Microsoft لملايين المستخدمين الآخرين. تقدم ملاحظاتك المحتوى لزوار Microsoft Learn الآخرين الذين يعتمدون على منتجات Microsoft ومحتوياتهم الداعمة.
في معظم الحالات، يتيح لك إرسال ملاحظات GitHub إرسال أفكارك إلى الفريق المسؤول عن مجموعة محتويات المنتج. يسمح مسار التعاون هذا بين فرق المحتوى ومستخدمي المنتجات بمشاركة الملاحظات ومناقشتها مباشرة في GitHub.
يمكن أن يوفر المساهمة في محتوى الوثائق مزايا احترافية لك أيضا. GitHub هو منصة معروفة حيث يمكن تقديم المساهمات التقنية وتتبعها. في كل مرة تساهم فيها في مشروع على GitHub، ينعكس ذلك في ملف تعريف GitHub الخاص بك. مع مرور الوقت، يمكنك إنشاء سجل لمساهماتك لإضافتها إلى محفظتك التقنية.
كيفية تقديم ملاحظات حول المحتوى
تذكر أن العديد من مقالات الوثائق على Microsoft Learn مخزنة في مستودعات GitHub. تم تمكين مشكلات GitHub في العديد من مستودعات GitHub. عند التمكين، يمكنك العثور على خيار إرسال ملاحظات لهذه الصفحة في أسفل مقالة حول learn.microsoft.com.
فيما يلي كيفية إرسال مشكلة في GitHub من مقالة Microsoft Learn:
انتقل إلى مقالة وثائق Microsoft Learn التي ترغب في تقديم ملاحظات بشأنها.
في أسفل المقالة، ابحث عن العنوان المسمى ملاحظات. إلى جانب السؤال هل كانت هذه الصفحة مفيدة؟، هناك أزرار ل نعمولا. حدد زرا للإشارة إلى ما إذا كانت المقالة مفيدة أم لا. يؤدي ذلك إلى فتح نموذج حيث يمكنك ملء تعليقاتك.
حدد سبب ملاحظاتك.
في مربع النص التالي، صف ملاحظاتك وقدم أي سياق ضروري.
عند الانتهاء، حدد إرسال.
يتم إعلام كاتب المقالة أو مالكي المحتوى الآخرين عند إرسال المشكلة.