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