كتابة تقنية

الأدوات

كذلك، برامج الرسوم البيانية. لتوصيل المعلومات الإحصائية، غالبًا ما تتضمن الكتابة التقنية رسومًا بيانية ومخططات انسيابية. تُستعمل برامج قواعد البيانات الشائعة عادةً لإنشاء رسوم بيانية ومخططات أساسية. أحيانًا، يتعين على الكتابة التقنية توفير رسوم بيانية أكثر تطورًا مع ميزات تفاعلية عبر الإنترنت. غالبًا ما تُستعمل برامج الرسوم البيانية لقواعد بيانات SQL لإنجاز هذا العمل.

ومن ناحية أخرى، يستعمل الكتاب الفنيون الأدوات التالية لتأليف وتقديم المستندات:

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

في هذا الإطار، برامج برمجية تعاونية. تتطلب الكتابة التقنية تعاونًا بين عدة أطراف من أقسام مختلفة داخل المؤسسة. لزيادة التواصل بين الأطراف، يعتمد الكُتّاب التقنيون على أنظمة ويكي مثل كونفلوينس ومساحات عمل المستندات المشتركة.

كذلك، أدوات التقاط الشاشة: تتضمن الكتابة التقنية لإجراءات البرامج في كثير من الأحيان لقطات للشاشة. هناك نوعان من التقاط الشاشة: إطار ثابت وفيديو. تُستعمل لقطات الشاشة ذات الإطار الثابت بشكل شائع في صناعة البرمجيات. غالبًا ما يُدرج الكُتّاب التقنيون لقطات شاشة ذات إطار ثابت للمساعدة في شرح الإجراءات الأكثر تعقيدًا. أحيانًا، قد يكتفي الكُتّاب التقنيون بتسجيل فيديو قصير لسطح مكتبهم لعرض إجراء برمجي. مع ذلك، يُعد هذا أقل شيوعًا نظرًا لكثرة المراجعات التي تُجريها البرامج.

كذلك، برامج المواصفات: غالبًا ما يستعمل "مُحدِّد المواصفات/الكاتب الفني" برامج المواصفات السحابية لاختيار قائمة بالمعايير الدنيا الشائعة المطلوبة لمشروع بناء. عادةً ما تُصمَّم هذه البرامج لتتوافق مع معايير معهد مواصفات البناء (CSI).

إضافةً إلى ذلك، أنظمة إدارة المحتوى (CMS): تُحرَّر وتُنشر الكتابة التقنية الحديثة في نظام إدارة محتوى (CMS) مُخصَّص مُصمَّم خصيصًا للكتابة التقنية. يُستعمل نظام إدارة المحتوى لنشر كميات كبيرة من محتوى الكتابة التقنية عبر الإنترنت بسهولة وسرعة. يُحوَّل المحتوى المُحمَّل تلقائيًا إلى نظام مساعدة "قاعدة معارف" ليتمكن المستعملون النهائيون من الرجوع إليه. فضلًا عن ميزات التحرير الأساسية بتقنية ما تراه هو ما تحصل عليه وإمكانية التحميل عبر الإنترنت، يُوفِّر نظام إدارة المحتوى كذلك ميزات إدارة المحتوى، بما في ذلك إدارة الإصدارات، وأدوات مُدمجة لإدارة سير عمل التوثيق الضخم. مُعظم أنظمة إدارة المحتوى المُستعملة في الكتابة التقنية تعتمد على لغة الترميز القياسي العام، أو لغة التوصيف القابلة للتوسعة، أو لغة تأشير توسعية لنص ترابطي.

ومن جهة أخرى، أدوات النشر المكتبي أو معالجات النصوص: في تسعينيات القرن الماضي، كانت أغلب الكتابة التقنية تُنجز باستخدام برامج معالجة النصوص. أتاحت هذه البرامج المبكرة للكتاب التقنيين تأليف وتحرير وتصميم وطباعة المستندات من جهاز كمبيوتر. ولا يزال مؤلفو الأوراق البيضاء يعتمدون عمومًا على معالجات النصوص وأدوات النشر المكتبي المُحسّنة للنشر المكتبي.

وفي السياق ذاته، تقديم كاد: غالبًا ما يستعمل الكُتّاب التقنيون العاملون في مجال الهندسة الميكانيكية أدوات عرض كاد لتوسيع نطاق تصميمات كاد ثلاثية الأبعاد المُعدّة والمعتمدة هندسيًا. الهدف هو توصيل خطوات التجميع/التفكيك بصريًا بشكل أوضح. عادةً ما تُستعمل برامج كاد المتخصصة في التواصل التقني لتعديل نماذج كاد الحالية.

الوثائق التقنية

وفي السياق ذاته، قاعدة المعرفة أو مركز المساعدة: مواقع مساعدة إلكترونية مصممة لتزويد المستعملين بصفحات معلومات تقنية حول المنتجات و/أو الخدمات. يمكن إنشاء محتوى هذه المواقع ورفعه على الويب باستخدام لغات لغة الترميز القياسي العام أو لغة التوصيف القابلة للتوسعة أو لغة تأشير توسعية لنص ترابطي. الكتابة التقنية: تُستعمل أنظمة إدارة المحتوى لإدارة هذه المواقع ورفعها.

وفي هذا السياق، تقرير التفتيش: يُستعمل هذا التقرير بشكل رئيسي في تشييد المباني الكبيرة والهندسة المدنية، ويُفصّل مشاكل/عيوب البناء التي يُحددها مفتش ميداني في مراحل مختلفة من المشروع. تُسجّل المشاكل/العيوب المُحدّدة، مبدئيًا، في قائمة مُهمّات. يستعين الكاتب الفني بهذه القائمة لكتابة تقرير التفتيش. تُقدّم تقارير التفتيش صورًا ومواقع وأوصافًا مُفصّلة للمشاكل/العيوب، ليسهل على البنّائين فهم أفضل السبل لإصلاحها أو إجراء الإصلاحات اللازمة. في بعض الحالات، قد تُضمّن كذلك حلول مُقترحة.

كذلك، دراسة الحالة: تقرير منشور عن شخص أو مجموعة أو موقف خضع للدراسة على مر الزمن؛ وهو كذلك موقف واقعي يمكن النظر إليه أو دراسته للتعمق في فهمه. في المؤسسات الكبيرة، لا يقدم الكُتّاب التقنيون سوى خدمات التحرير أو الكتابة بالنيابة لدراسات الحالة. يُشترط عادةً تأليف مواد على مستوى الإدارة لتلبية المعايير والقواعد الوطنية.

من جهة ثانية، إجراءات التشغيل القياسية (SOPs): الخطوات الإجرائية التي يتبعها أفراد السلامة العسكرية والتصنيعية والطبية والصناعية لإنجاز التجميع أو المعالجة أو أي مهمة عمل أخرى يجب إكمالها فعليًا بالترتيب الصحيح.

علاوةً على ذلك، تعليمات التجميع (AI): تُقدم إجراءات داخلية لموظفي خط التجميع. تُكتب الخطوات الفردية وتُوزّع على أعضاء فريق التجميع. غالبًا ما يُدرج الكاتب الفني نماذج CAD لتبسيط عمليات التجميع المعقدة.

إضافةً إلى ذلك، توثيق واجهة برمجة التطبيقات (API): يُستعمل حصريًا في مجال تطوير الويب لتوثيق تعليمات التشغيل والتثبيت لواجهة برمجة التطبيقات. تتيح أدوات ترميز واجهة برمجة التطبيقات (مثل سواجر ويوست مان وغيرهما) للكتاب التقنيين إنشاء توثيقات بسهولة بتنسيق ماركداون لرفعها إلى أدلة توثيق واجهة برمجة التطبيقات محددة تحتوي على شيفرة توثيق واجهة برمجة التطبيقات ذات صلة (مثل واجهة برمجة تطبيقات التوطين، وواجهة برمجة تطبيقات تسجيل الدخول، وواجهة برمجة تطبيقات الأمان). عادةً ما يتم تحويل توثيق واجهة برمجة التطبيقات تلقائيًا إلى تنسيق ماركداون موحد داخل محرر ما تراه هو ما تحصل عليه الخاص بأداة واجهة برمجة التطبيقات. في أغلب الحالات، يقوم المبرمجون والكتاب التقنيون بتحميل الشيفرة وتحديثات المحتوى إلى مستودع «غيت» حيث يتم الاحتفاظ بصورة طبق الأصل من موقع الويب. لاحقًا، ينقل المبرمجون الأدلة المحدثة إلى الخادم المباشر بمجرد اكتمال الاختبار.

إضافةً إلى ذلك، محتوى التسويق الفني: معلومات كُتبت خصيصًا لأغراض التسويق. يُستعمل هذا المحتوى غالبًا للمساعدة في وصف معلومات المنتج ومواصفاته في المواد التسويقية وعلى صفحات الويب الخاصة بالمنتج/الخدمة. عادةً ما يُستعان بكتاب مبدعين متخصصين في التسويق لهذا العمل.

وفي هذا الصدد، أدلة المستعمل (UM) أو كتيبات التشغيل: تعليمات إجرائية لتشغيل منتج أو برنامج.

ومن جهة أخرى، قائمة التعبئة أو قائمة الشحن: تحدد الأجزاء التي تم شحنها وبيانات سلامة المنتج ومعلومات الاتصال بالشركة المصنعة.

وعلى صعيد آخر، أدلة صيانة المكونات (CMMs): تُستعمل بشكل رئيسي في مجال الطيران والفضاء لإخطار العملاء عند الحاجة إلى إصلاح أو استبدال أي مكون كامل. يجب تضمين جميع نشرات الخدمة المتعلقة بالمكونات و/أو الإشارة إليها في دليل صيانة المكونات، فضلًا عن أحدث رسومات المكونات ومعلوماتها. تتبع أدلة صيانة المكونات تنسيق رابطة النقل الجوي الفضائي (ATA) وفصول ATA Spec 100/iSpec 2200.

ومن ناحية أخرى، أدلة التثبيت (IM): إجراءات مصممة لمساعدة المستعمل النهائي في تثبيت منتج أو برنامج في الميدان.

من جانب آخر، المواصفات: تُستعمل في قطاع البناء لتحديد الحد الأدنى من معايير ومتطلبات التركيب. عادةً ما يُقدّم مدير المشروع المواصفات إلى البنّاء، ويجب أن يوقّعها البنّاء ويقبلها كجزء من العقد. يُحدّد معهد مواصفات البناء (CSI) معايير التنسيق.

من جهة ثانية، تشمل الكتابة التقنية أنواعًا وأساليب كتابة متعددة، تبعًا للمعلومات والجمهور المستهدف. من أمثلة الوثائق التقنية الشائعة:

في هذا الإطار، أوراق بيضاء: وثائق تسويقية، غالبًا ما يكتبها كُتّاب تقنيون، وتُنسب إلى خبراء في مجالهم. جميع الأوراق البيضاء تتناول موضوعًا مقنعًا، وتُقدّم حُجة تدعم استنتاج الكاتب.

وفي هذا السياق، نشرات الخدمة (SBs): تُستعمل هذه الأدلة بشكل رئيسي في مجال الطيران، وهي مخصصة للإصلاحات والتعديلات البسيطة. يُصدر المصنعون نشرات الخدمة ويُصدرونها لمالكي الطائرات عند الحاجة إلى تعديل أو تحديث أي جزء من مكونات الطائرة. تتبع نشرات الخدمة تنسيق جمعية النقل الجوي (ATA) ومواصفات ATA 100/iSpec 2200.

من جهة ثانية، ورقة المواصفات/أوراق المواصفات أو أوراق البيانات: أوراق مرجعية من صفحة أو صفحتين، مصممة لتوفير الخصائص المشتركة للمنتج/الخدمة المطلوبة لتطبيقات محددة. قد تشمل الخصائص القصوى والدنيا المشتركة للمنتج/الخدمة: الحجم والمساحة، الوزن، نوع التوصيلات أو الواجهات، المتطلبات الكهربائية، السرعة، إلخ.

نظرة عامة

ومن جهة أخرى، تتم الكتابة التقنية في أغلب الأحيان بواسطة كاتب فني مدرب والمحتوى الذي ينتجه هو نتاج عملية محددة جيدًا. يتبع الكتاب الفنيون إرشادات صارمة حتى تظهر الكتابة التقنية التي يشاركونها بتنسيق وأسلوب موحد وموحد الاستخدام (مثلًا، ديتا، تنسيق ماركداون، ، دليل أسلوب شيكاغو). إن المهمة الأساسية للكاتب التقني هي توصيل المعلومات التقنية بأوضح طريقة ممكنة وأكثرها فعالية. لتحقيق أعلى مستوى من الوضوح، يجب أن تكون الكتابة التقنية للمنظمة غير قابلة للتمييز بالنسبة للقارئ – دون أي اختلافات في التنسيق أو القواعد أو الأسلوب المعمول به بين المؤلفين. غالبًا ما يكون موضوع الكاتب التقني معقدًا، لذا فإن مهارات الكتابة والتواصل القوية ضرورية. لا تقتصر الكتابة التقنية بأي حال من الأحوال على التواصل الكتابي. غالبًا ما يتم دمج الاتصال المرئي في الوثائق للمساعدة في تبسيط الموضوعات المعقدة. يستعمل الكتاب التقنيون مجموعة متنوعة من برامج تحرير الصور والرسومات الحديثة لإنتاج اتصالات مرئية. تعد برامج تحرير الرسوم التوضيحية والمخططات والتصميم بمساعدة الكمبيوتر أدوات شائعة في التجارة.

كذلك، في بعض الحالات، قد يُجري المهندسون الكتابة التقنية للمشروع الذي يعملون عليه، ولكن نادرًا ما يحدث هذا في المؤسسات الكبيرة حيث يجب إصدار المنتجات أو مراجعتها أسبوعيًا. أما على الصعيد التجاري، فعادةً ما يكتب كُتّاب مُدرَّبون في مجال التسويق و/أو الكتابة الإبداعية المواد التسويقية أو البيانات الصحفية. ومع ذلك، يُمكن الاعتماد على كاتب فني لتقديم التحرير والمدخلات الأخرى لأي محتوى فني قد تُنتجه المؤسسة.

التاريخ

في هذا الإطار، بعد الحرب العالمية الثانية، أدى التقدم التكنولوجي إلى زيادة السلع الاستهلاكية ومستويات المعيشة. خلال فترة الطفرة التي أعقبت الحرب العالمية الثانية، شهدت الخدمات العامة مثل المكتبات والجامعات، فضلاً عن أنظمة النقل مثل الحافلات والطرق السريعة، نمواً كبيراً. لقد زادت الحاجة إلى أن يقوم الكتاب بتوثيق هذه العمليات. كما شهدت هذه الفترة كذلك بدء الشركات الكبرى والجامعات في استخدام أجهزة الكمبيوتر. ومن الجدير بالذكر أنه في عام 1949، قام جوزيف د. تشابلين بتأليف أول وثيقة تقنية حسابية، وهي دليل تعليمات لجهاز كمبيوتر BINAC.

علاوةً على ذلك، مع اختراع المطبعة الميكانيكية، وبداية عصر النهضة، وظهور عصر العقل، أصبح توثيق النتائج ضرورة. قام المخترعون والعلماء مثل إسحاق نيوتن وليوناردو دافنشي بإعداد وثائق توثق اختراعاتهم واكتشافاتهم. على الرغم من عدم تسميتها أبدًا بالوثائق التقنية خلال فترة نشرها، إلا أن هذه الوثائق لعبت دورًا حاسمًا في تطوير الأشكال الحديثة للاتصالات والكتابة التقنية.

علاوةً على ذلك، خلال القرن العشرين، ارتفعت الحاجة إلى الكتابة التقنية بدرجة كبيرة، وأصبحت المهنة معترف بها رسميًا. أدت أحداث الحرب العالمية الأولى والحرب العالمية الثانية إلى تقدم في الطب، والمعدات العسكرية، وتكنولوجيا الكمبيوتر، وتكنولوجيا الفضاء الجوي.  وقد أدى هذا النمو السريع، إلى جانب إلحاح الحرب، إلى خلق حاجة فورية إلى توثيق مصمم بشكل جيد لدعم استخدام هذه التقنيات. كان الطلب على الكتابة التقنية مرتفعًا خلال هذا الوقت، وأصبح "الكاتب التقني" عنوانًا وظيفيًا رسميًا خلال الحرب العالمية الثانية.

إضافةً إلى ذلك، رغم أن الكتابة التقنية لم يتم الاعتراف بها كمهنة إلا منذ الحرب العالمية الثانية، إلا أن جذورها تعود إلى مصر القديمة، حيث تم استخدام الاتصال المرئي بانتظام لشرح الإجراءات. في العصور اليونانية والرومانية القديمة، تم الاستشهاد بالكتابة التقنية من خلال أعمال كتاب مثل أرسطو وديموكراتس باعتبارها بعضًا من أقدم أشكال الكتابة التقنية المكتوبة. أقدم الأمثلة على ما يمكن اعتباره كتابة تقنية إجرائية حديثة ترجع إلى الكيميائيين الأوائل. قام هؤلاء العلماء الأوائل بتطوير ما نعرفه الآن باسم " الوصفات ". يعود تاريخ بعض أقدم الاكتشافات للخطوات الإجرائية المكتوبة في الحضارة الغربية إلى عام 1100 بعد الميلاد، ومع ذلك، فقد تم استخدام الاتصال المرئي لوصف إجراءات الخطوات في الهند والصين القديمة قبل ذلك بكثير.

في هذا الإطار، سمح اختراع الترانزستور في عام 1947 بإنتاج أجهزة الكمبيوتر بتكلفة أقل وفي متناول الأفراد والشركات الصغيرة.  مع نمو سوق " أجهزة الكمبيوتر الشخصية " هذه، ازدادت الحاجة إلى كتاب قادرين على شرح هذه الأجهزة وتوفير وثائق المستعمل لها.  شهدت مهنة الكتابة التقنية توسعًا أكبر خلال السبعينيات والثمانينيات مع دخول الأجهزة الإلكترونية الاستهلاكية إلى منازل المزيد والمزيد من الناس.

وعلى صعيد آخر، لقد شهد مجال الاتصالات التقنية نموًا خلال الثورة الصناعية. كانت هناك حاجة متزايدة لتزويد الناس بالتعليمات لاستخدام الآلات المعقدة بشكل متزايد والتي تم اختراعها.  ومع ذلك، وعلى عكس الماضي، حيث كانت المهارات تنتقل من خلال التقاليد الشفهية، لم يكن أحد سوى المخترعين يعرف كيفية استخدام هذه الأجهزة الجديدة. وهكذا أصبحت الكتابة هي الوسيلة الأسرع والأكثر فعالية لنشر المعلومات، وكان هناك طلب على الكتاب الذين يستطيعون توثيق هذه الأجهزة.

وعلى صعيد آخر، في السنوات الأخيرة، أدى بروز أجهزة الكمبيوتر في المجتمع إلى الكثير من التطورات في مجال الاتصالات الرقمية، مما أدى إلى تغييرات في الأدوات التي يستعملها الكتاب التقنيون. لقد جعلت النصوص التشعبية، ومعالجات الكلمات، وبرامج تحرير الرسومات، وبرامج تخطيط الصفحات إنشاء المستندات التقنية أسرع وأسهل، ويجب على الكتاب الفنيين اليوم أن يكونوا بارعين في هذه البرامج.

قائمة الجمعيات

منظمة الاتصالات التقنية (متوقف اعتبارًا من عام 2025)

المراجع