كيف تكتب عن البرمجيات المفتوحة المصدر؟

مقدمة:

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

عمّ تكتب؟

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

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

كتابتك تعكس شخصيتك، ولن يروي أحد القصة بالطريقة التي ترويها أنت. وربما كانت تجاربك ورؤيتك هي بالضبط ما يحتاج إليه شخص آخر. وإليك أسئلة تساعد على إيجاد موضوع.

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

ما نوع المحتوى الذي تكتبه؟

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

لمن تكتب؟

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

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

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

الكلمات تصنع فرقًا

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

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

استخدم أدوات مثل Hemingway App لفحص سهولة القراءة. وهي ليست مفتوحة المصدر لكنها ممتازة. فبعد مسودته الأولى قُدّر مستوى هذا المقال بالصف الخامس. وتقترح الأداة كذلك تحسينات، فتحدد الجمل الصعبة والمواضع التي تحتاج إلى تغيير الكلمات. وإذا صعب عليك إيجاد بدائل، فراجع اقتراحات Plain English Campaign أو البدائل التي يشارك الجمهور في جمعها على Power Thesaurus.

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

عند كتابة شرح أو دليل عملي، تجنب وصف الخطوات بأنها «بسيطة» أو «سهلة»، أو تقديمها بعبارة «ما عليك إلا». فقد تراها سهلة بعد سنوات من الممارسة، لكن المبتدئ قد لا يجدها كذلك، وقد يشعر بالإحباط لأن العملية أو الشرح لا يبدوان له سهلين.

هل اضطررت يومًا إلى إعادة قراءة جملة أو فقرة مرات لأنك لم تفهم ما يريد الكاتب قوله؟ وهل تركت مقالًا لأنه لم يكن مفهومًا؟ حدث لي ذلك. فهل تريد أن يشعر قراؤك بالحيرة أو بقلة الذكاء؟ آمل ألا تريد.

ومن الكلمات الإنجليزية التي تنصح الكاتبة بمراجعتها: that وreally وvery وso وin order to. ويمكن عادة حذفها دون تغيير معنى الجملة. وبعد انتهاء الكتابة أبحث عن مواضعها في المستند.

وحين بحثت في هذا المقال، وجدت الجملة الآتية: “This doesn’t imply that your audience only has an eighth-grade education, it means that your writing will be more easily understood.” وتحتوي على that مرتين دون فائدة ضرورية. وحذفهما يقصر الجملة، والجمل الأقصر أسهل فهمًا. ثم قسمتُها إلى جملتين: “This doesn’t imply your audience has only an eighth-grade education. It means your writing will be more easily understood.” والمعنى بالعربية: «لا يعني ذلك أن تعليم جمهورك توقف عند الصف الثامن. بل يعني أن كتابتك ستصبح أسهل فهمًا».

ملاحظة ترجميّة: أُبقي مثال التحرير الإنجليزي لأن أثر حذف that متعلق ببنية اللغة الأصلية؛ ولا يُفهم منه وجوب حذف ما يقابلها في كل جملة عربية.

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

المراجعة والتحرير

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

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

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

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

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

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

لا تخش طلب المساعدة في كتابتك؛ فخلف كل كاتب جيد محرر جيد أو تطبيق تحرير جيد.

أدلة الأسلوب

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

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

المراجع

• https://www.redhat.com/sysadmin/questions-for-employer?intcmp=7013a000002DRawAAG
• https://www.redhat.com/architect/?intcmp=7013a000002DRawAAG
• https://enterprisersproject.com/article/2019/3/article-cheat-sheet?intcmp=7013a000002DRawAAG
• https://www.hemingwayapp.com/
• https://www.plainenglish.co.uk/the-a-z-of-alternative-words.html
• https://www.powerthesaurus.org/
• https://open.buffer.com/inclusive-language-tech/
• https://languagetool.org/
• https://www.chicagomanualofstyle.org/home.html
• https://developers.google.com/style
• https://docs.microsoft.com/en-us/style-guide/welcome/
• https://www.apstylebook.com/