تحتوي هذه الصفحة على تفاصيل مشروع كتابة فنية تم قبوله في "موسم مستندات Google".
ملخّص المشروع
- مؤسسة مفتوحة المصدر:
- Qubes OS
- الكاتب الفني:
- c1e0
- اسم المشروع:
- توحيد أدلة تحديد المشاكل وحلّها
- طول المشروع:
- مدة زمنية عادية (3 أشهر)
وصف المشروع
ABSTRACT
تم تصميم دليل تحديد المشاكل وحلّها لمساعدة المستخدمين النهائيين في حلّ أي مشاكل تواجههم عند استخدام منتج أو خدمة. من المهم أن يتضمّن الدليل خطوات جيدة لاستكشاف الأخطاء وحلّها، لأنّ ذلك يساعد المستخدمين عند حدوث مشاكل. يمنع المستخدمين من التخلي عن المنتج عندما يواجهون مشكلة. يستخدم آلاف المستخدمين Qubes يوميًا حول العالم، وسيواجه الكثير منهم مشكلة في وقت ما وسيستفيدون من دليل تحديد المشاكل وحلّها.
الحالة الحالية لدليل تحديد المشاكل وحلّها
في الوقت الحالي، تكون أدلة تحديد المشاكل وحلّها لنظام QubesOS متفرقة على العديد من الصفحات وقد تكون غير مكتملة أحيانًا، ما يؤدي إلى نشر التعليمات نفسها مرارًا وتكرارًا عند مساعدة المستخدمين في تشخيص المشاكل. تفتقر الأدلة المتاحة إلى تخطيط إجراءات الأعراض، مما يجعل من الصعب على المستخدم مطابقة مشكلة مع حلها. بالإضافة إلى ذلك، هناك بعض المشاكل التي تمت الإشارة إليها مرارًا وتكرارًا على وسائل التواصل الاجتماعي (Reddit)، وصفحة مشاكل Qubes GitHub، وعلى منتدى المستخدمين #qubes، ولكن لم يتم توثيقها في الدليل الحالي لتحديد المشاكل وحلّها.
لماذا يُعدّ دليل تحديد المشاكل وحلّها المقترَح لدينا أفضل من الدليل الحالي؟
سيكون دليل تحديد المشاكل وحلّها المقترَح كاملاً ومنظَّمًا لضمان الدقة وسهولة التنقّل. سيعرض الدليل تعليمات موجزة توضّح كيفية حلّ مشكلة بطريقة تدريجية. وسيتضمّن تنسيقًا يعرض الأعراض والإجراءات، حيث سيتم توضيح المشكلة، ثم حلّ مقترَح لحلّها. وستكون عملية تحديد المشاكل وحلّها محسَّنة على محرك بحث وتمت صياغتها لمراعاة المشاكل التي يبحث عنها المستخدمون على وسائل التواصل الاجتماعي ومحركات البحث. سيؤدي ذلك إلى ضمان تمكّن المستخدمين من العثور على دليل تحديد المشاكل وحلّها الرسمي من خلال محرّكات البحث والعثور على حلّ لمشاكلهم بسرعة أو بسهولة.
بنية دليل تحديد المشاكل وحلّها المقترَح والإطار الزمني
لقد أنشأتُ بنية مقترَحة لدليل تحديد المشاكل وحلّها في نظام التشغيل Qubes OS، ويمكن العثور عليه هنا: https://docs.google.com/document/d/187NlnEvctYVVUnRuGtwY2PkYBVxBSSPfpSwZEaczqL8/edit?usp=sharing. يكون التخطيط مصحوبًا بإطار زمني تقديري ستتم خلاله كتابة كل قسم من أقسام استكشاف الأخطاء وإصلاحها. سيتم تنفيذ هذا التنسيق بعد الحصول على ملاحظات من المرشد. قد يتم تعديل البنية والإطار الزمني استنادًا إلى ملاحظات المرشد.
أهداف المشروع
- إعادة تنظيم دليل تحديد المشاكل وحلّها لتوفير تنسيق أكثر وضوحًا وشمولاً للأعراض والإجراءات
- إعادة كتابة خطوات تحديد المشاكل وحلّها الحالية لتوفير تعليمات خطوة بخطوة سهلة المتابعة
- أضِف لقطات شاشة عند الضرورة.
- تثبيت Qubes وتجربته بنفسي وتسجيل أي مشاكل واجهتها لديّ ثلاثة أجهزة كمبيوتر: Lenovo Thinkpad وDell Latitude وAcer Aspire. سأحاول تثبيت Qubes على كل من أجهزة الكمبيوتر هذه، وسأسجِّل أي أخطاء وأتحقّق من أي مشاكل وحلّها.
- أزِل أي معلومات قديمة في الدليل الحالي.
- تأكَّد من دقة عمليات تحديد المشاكل وحلّها. في الوقت الحالي، تتضمّن أدلة تحديد المشاكل وحلّها الحالية رسالة الخطأ "هذه مستندات غير رسمية تابعة لجهة خارجية. لا يمكن لمشروع Qubes OS ضمان دقة هذه الصفحة. يُرجى توخّي الحذر"". سيتم تجاهل هذا التحذير بعد التأكّد من دقة تعليمات تحديد المشاكل وحلّها. وسيتم ضمان دقتها إما من خلال إجراء اختبار شخصي لتحري الخلل وإصلاحه على أجهزة الكمبيوتر الشخصية (إن أمكن)، أو التحقق عبر الإنترنت مما إذا كان أي من المستخدمين قد تحقق من صحة الحل.
- نقل أيّ خطوات تحديد المشاكل وحلّها الخارجية (من المنتدى وGitHub) إلى صفحة الويب الرسمية لتحديد المشاكل وحلّها
- يمكنك البحث عن المزيد من المشاكل التي يواجهها المستخدمون من Reddit (r/QubesOS) وStack Exchange ومجموعة مستخدمي #qubes في Google ومشاكل GitHub. سأستخدِم أيضًا أدوات البحث عن الكلمات الرئيسية، مثل Keywordtool.io وUberSuggest.com، لمعرفة الأسئلة التي يتم البحث عنها بشكل متكرّر على محرّكات بحث مثل Google.
- أضف قسم "الحصول على المساعدة"، إذا لم يحل دليل تحديد المشاكل وحلّها مشكلة المستخدمين. يمكنك الاطّلاع على مثال في صفحة تحديد المشاكل وحلّها في Fedora: https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/install/Troubleshooting/#sect-troubleshooting-getting-help.
ما سبب هذا المشروع؟
أنا من المهتمين بالتكنولوجيا، لا سيما الأمن السيبراني والخصوصية. أعتقد أنّ الكتابة هي من أقوى ألعابي. أنا مهتم بشكل خاص بنظام التشغيل Qubes لأنّه يجمع بين اهتمامين رئيسيين لديّ: الأمان والخصوصية. أنا من المستخدمين المهتمين بالمنتجات الأخرى التي تركّز على الأمان والخصوصية، مثل DuckDuckGo وTor. لقد اكتشفتُ مؤخرًا نظام التشغيل Qubes، وأحببته كثيرًا حتى الآن.
لماذا أعتقد أنني الشخص المناسب لهذا المشروع
- أنا من المهتمين بالأمان والخصوصية وكتابة مستندات جيدة ومفيدة.
- بما أنّني واجهت مشاكل عند تثبيت نظام تشغيل Qubes واستخدامه، سأتمكّن من توضيح هذه المشاكل بشكل أفضل في تعليمات تحديد المشاكل وحلّها.
- في الشهر الماضي، درست الجوانب الفنية لنظام التشغيل Qubes. لقد درست أيضًا مستندات نظام التشغيل Qubes بشكل مكثّف. للتعرّف على عملية تعديل المستندات، أنشأتُ طلبًا لإضافة المحتوى (https://github.com/QubesOS/qubes-doc/pull/1005/files).
- لقد أكملتُ مؤخرًا فترة تدريب في مشروع Tor. وكانت وظيفتي هي الدعم الفني والكتابة. أثناء عملي في مركز المساعدة، تلقّيت مئات الأسئلة من المستخدمين الذين واجهوا مشاكل عند تثبيت متصفّح Tor أو استخدامه. من خلال مساعدة هؤلاء المستخدمين في تحديد مشاكلهم وحلّها، تعلمت كيفية كتابة تعليمات موجزة ومفهومة لتحديد المشاكل وحلّها.
- أثناء عملي في مشروع Tor، كتبت أيضًا مستندات فنية باستخدام Markdown. لقد استخدمت Git وGitHub وGitLab للتحكّم في الإصدارات.