في تطوير البرمجيات، نقوم بجمع الأنماط المضادة للتعرف على السمات الشائعة التي تؤدي إلى نتائج سيئة. اعتقدت أنه سيكون من المفيد فعل الشيء نفسه للتدوين البرمجي، لذلك قمت بتصنيف الأخطاء الأكثر تكرارًا التي أراها من المدونين المبتدئين.
الخطأ الأكثر شيوعًا هو التشتت. يحب المطورون التحديد، لذلك يبدأون منشورات المدونة بقصة خلفية وسياق تاريخي. قد يكون هذا ممتعًا للكتابة، لكنه ليس دائمًا مثيرًا للاهتمام للقراءة. من منظور القارئ، هناك مليارات المقالات الأخرى التي يمكنه قراءتها. امنح نفسك العنوان والجمل الثلاث الأولى للإجابة: هل كتب المؤلف هذا لشخص مثلي؟ كيف سأستفيد من قراءته؟
يكتب بعض المدونين مقدمة مقنعة لكنهم يثقلون طريق القارئ بإضافات مثل عنوان فرعي أو سيرة ذاتية أو صورة. كل ما تضعه في طريق القارئ يستهلك من مخزونه المحدود من التركيز. يقارن المعلمون الفعالون المفاهيم الجديدة بشيء مألوف للقارئ. على سبيل المثال، إذا كنت تشرح Jellyfin، قد تقول: "Jellyfin هي خدمة بث مثل Netflix، لكنها مفتوحة المصدر وخاصة." قلل من افتراضاتك حول القارئ.
عندما تكتب منشور مدونة، فكر في القارئ المستهدف. ماذا يعرف؟ تخيل صديقًا أو زميلًا في الفريق تعرفه في الحياة الواقعية. اكتب قائمة بالمصطلحات التي سيتعرف عليها والمصطلحات التي لن يتعرف عليها.
المصدر: Hacker News · لخّصه HeadlinesBriefing