توثيق البرمجيات: الفرق بين النسختين
| [مراجعة غير مفحوصة] | [مراجعة غير مفحوصة] |
تم حذف المحتوى تمت إضافة المحتوى
ط روبوت: إزالة وصلات ذاتية |
|||
سطر 64:
=== التوثيق المخصص للمستخدم النهائي===
بخلاف توثيق شيفرة البرمجة، فإن المستندات التي تنتج للمستخدمين تكون بسيطة وتصف كيفية استخدام البرنامج. في حالة [[مكتبة البرمجية]]، قد تكون وثائق شيفرة البرمجة code ووثائق المستخدمين متكافئة ويمكن دمجها، لكن لا ينطبق الأمر على التطبيقات العامة.
عادة ما تصف الوثائق التي تنتج للمستخدم النهائي كل خاصية من خصائص البرنامج، وتساعد المستخدم على إدراك ماهية هذه الخصائص. وقد تتضمن هذه الوثائق تعليمات مساعدة لكشف الخلل والمشاكل في البرنامج وطرق التعامل معها. من الأهمية بمكان أن تكون وثائق المستخدم بسيطة وسهلة، ولا تسبب الارتباك للمستخدم، كما يجب أن تكون قابلة للتعديل والتحديث. لا يوجد تنظيم معين يجب أن يتبع عند إعداد وثائق المستخدم النهائي، لكن لا بد أن تحتوي الوثيقة على [[فهرس]]. كما يجب أن تتصف هذه الوثائق بالاتساق والبساطة. هذا وقد تعتبر وثائق المستخدم النهائي بمثابة عقد يوضح الأهداف التي بنيت البرمجية لتحقيقها والوظائف التي تؤديها (أنظر أيضاً: [[كتابة تقنية|الكتابة التقنية]].
There are three broad ways in which user documentation can be organized.
| |||