إمكانية الوصول إلى الوثائق

استراتيجيات جمع البيانات

• استخدم أداة تقيم ملاءمة قارئ الشاشة. (5) (6) لتحديد ما إذا كانت الوثائق مناسبة لقارئ الشاشة؟
• مقابلة الوافدين الجدد لمعرفة كيف ساعدت التوثيق في ، (أ) فهم عملية المساهمة ، و / أو ، (ب) المساعدة على إكمال المهام في المشروع. عينة أسئلة المقابلة:
  • ما هي تجربتك في استخدام الوثائق لفهم عملية المساهمة؟
  • ما هي خبرتك في استشارة الوثائق عندما يكون لديك سؤال حول القيام بالعمل في المشروع؟
  • هل كنت مرتاحًا للمصطلحات الفنية الموجودة في الوثائق؟

• الدراسة الاستقصائية أعضاء المشروع

  • عنصر المصفوفة: عندما تحتاج إلى تحديد موقع معلومات حول عمليات أو سياسات أو إرشادات هذا المشروع ، أي مما يلي يصف تجربتك؟ (2)

  • يمكن أن تكون صفوف المصفوفة:

    • الاتصالات القائمة البريدية
    • التواصل عبر الدردشة
    • أداء مراجعات التعليمات البرمجية
    • عملية الحصول على الكود مقبولة
    • القواعد السلوكية
    • إعداد الوافدين الجدد
    • الترخيص
    • علامة تجارية
    • إضافة Committers / مشرفين جدد
    • إصدارات المشروع
    • عملية التصويت
    • إجراءات التثبيت
    • تطوير الميزات
    • تكامل واجهة برمجة التطبيقات
    • أجنحة الاختبار
    • نظرة عامة على العمارة
    • دليل المستخدم
  • يمكن أن تكون أعمدة المصفوفة:
    • من السهل دائمًا العثور عليه
    • سهل الإيجاد
    • من الصعب العثور على
    • من الصعب جدا العثور عليها
  • الاختيار من متعدد: هل واجهت أي تحديات تتعلق بإمكانية الوصول إلى الوثائق عندما بدأت المشاركة في المشروع (على سبيل المثال ، حواجز اللغة ، وإمكانية اكتشاف الوثائق ، وهيكل التوثيق)؟ (2)
  • خيارات الإجابة:
    • لا توجد تحديات
    • قليل من التحديات
    • عدة تحديات
    • العديد من التحديات
  • سؤال متابعة مفتوح إذا كانت الإجابة ليست "لا توجد تحديات": صف مثالاً على وقت مواجهة التحدي ، وكيف أثر التحدي عليك ، وكيف تغلبت على التحدي على الإطلاق.
  • سؤال مفتوح: ما هي الاقتراحات التي لديك لتحسين سياسات المشروع أو عملياته أو إرشاداته المتاحة للمساهمين الجدد؟ (2)
• ابحث عن تنظيم التركيبات المتعلقة بقابلية القراءة والقابلية للمسح مثل:
  • العناوين
  • كتل النص والتعليمات البرمجية
  • تعداد نقطي أو فقرات
  • المراسي
• تقييم إمكانية البحث من خلال مراعاة:
  • ما مدى سهولة العثور على هذه الوثائق من قبل المستخدم؟
  • ما مدى سهولة العثور على المستخدم ما يحتاجه في الوثائق؟
  • هل المستند سهل التنقل باستخدام لوحة المفاتيح؟
• قدم استبيانًا سريعًا سريعًا بسؤال واحد فقط لقراء الوثائق (على سبيل المثال ، الصفحة السفلية أو النافذة المنبثقة عند مغادرة صفحة التوثيق):
  • نعم / لا سؤال: هل كانت صفحة التوثيق هذه في متناولك؟
  • مقياس ليكرت [1-x]: ما مدى سهولة الوصول إلى هذه الوثائق بالنسبة لك؟
  • إجابة قصيرة: ما هو شعورك حيال إمكانية الوصول إلى الوثائق؟
• تجول مع المستخدمين المستهدفين للوثائق. لاحظ كيف يتفاعلون ويستخدمون الوثائق وأين يتعثرون. يمكن أن تكون هذه جلسة مؤتمر عبر الفيديو حيث يشارك مستخدم الوثائق شاشته.
• اطلب من مستخدمي الوثائق كتابة ملف سجل الاحتكاك ووصف المشكلات التي واجهوها مع التوثيق. هذا يعطي حالات استخدام ملموسة لمحرري الوثائق لفهم كيفية تحسين التوثيق لمستخدم معين.
• فكر فيما إذا كانت هناك إصدارات مختلفة من الوثائق متاحة لجمهور مختلف؟ على سبيل المثال، إصدار خفيف الوزن وإصدار مفصل للغاية

فلتر

• احتياجات المستخدم (على سبيل المثال، ضعف البصر، والتنوع المعرفي)
• النسخة اللغوية للوثائق
• نوع التوثيق (على سبيل المثال، دليل البدء السريع، مرجع واجهة برمجة التطبيقات)

المرئيات

• لا شيء محدد