كتب technical documentation
اذا لم تجد ما تبحث عنه يمكنك استخدام كلمات أكثر دقة.
التوثيق التقني (معلومة)
التوثيق التقني هو ما يقصده مبرمج عندما يستخدمون التعبير توثيق البرمجيات. عندما يتم إنشاء برمجية فإن Code لا تكفي وحدها. يجب أن تتوفر أيضاً بعض النصوص التي تصف الجوانب المختلفة للعمليات المطلوب من البرمجية تنفيذها. من الأهمية بمكان أن تكون وثائق الشيفرة البرمجية شاملة، لكن يجب في الوقت ذاته أن لا تكون طويلة بحيث يصعب تعديلها وحفظها. تستخدم برامج API Writer لكتابة العديد من الوثائق الخاصة بالبرمجيات كتعليمات الاستخدام. قد تستخدم الوثائق التقنية من قبل المبرمجين أو فاحصي البرامج والمستخدم النهائي للبرمجية. في الوقت الراهن، نرى العديد من التطبيقات المتقدمة المستخدمة في شتى المجالات كالطاقة والنقل والشبكات والفضاء والأمن والحماية والأتمتة الصناعية ومجالات أخرى عديدة. أصبح التوثيق التقني هاماً في هذه المجالات، نظراً لتغيير المعلومات الأساسية والمتقدمة بسرعة خلال فترات زمنية قليلة بما في ذلك التغيرات التي تجرى على معمارية البرامج. لذا، اكتسب التوثيق التقني أهمية عظيمة مؤخراً خصوصاً في عالم البرمجيات. غالباً ما تستخدم أدوات إنشاء الوثائق (كـ دي أكسجين، NDoc، javadoc، EiffelStudio) لإنشاء ملفات الشيفرة البرمجية أوتوماتيكياً، أي أنها تستخلص الملاحظات وتبنى التصميم بالعقود من الشيفرة المصدرية وتُنشئ كتيبات مرجعية ذات صيغ ملفات نصية أو ملفات لغة ترميز النص الفائق. غالباً ما تنظّم ملفات الشيفرة البرمجية بأسلوب "الدليل المرجعي"، ما يتيح للمبرمج سرعة البحث عن class أو وظيفة معينة في البرمجية.
إن فكرة إنشاء التوثيق أوتوماتيكياً جاذبة للمبرمجين لعدة أسباب. على سبيل المثال، نظراً لكون هذه الوثائق مستخلصة من الشيفرة المصدرية نفسها (مثلاً باستخدام الملاحظات والتعليقات) يمكن أن يكتبها المبرمجون عند مراجعة الشيفرة البرمجية، كما يمكنهم استخدام نفس الأدوات المستخدمة لإنشاء الشيفرة البرمجية للوثائق. وهذا يسهّل عملية تحديث الوثائق. إحدى سلبيات هذه الأداة هي أن المبرمجين يستطيعون تعديد هذا النوع من الوثائق، وتقع على عاتقهم مسؤولية تحديثها للحصول على المخرجات. هذا ويعتقد البعض أن هذه ميزة إيجابية بدلاً من كونها سلبية. غالباً ما يحتاج المبرمجون إلى القدرة على إنشاء المعلومات التي لن تكون جزءاً من الشيفرة المركزية، أي كتابة تعليقات وهوامش معينة، والوصول إليها. تكون هذه المعلومات جزءاً من الأنشطة البرمجية العديدة كتتبّع الشيفرة البرمجية وترقيتها. وهي بذا تساعد المبرمج في أي مرحلة من مراحل إنشاء البرامج على التتبع والصيانة. يستخدم Kelp لتخزين التعليقات في ملفات منفصلة وربط المعلومات بالشيفرة المصدرية ديناميكياً.
