Anti-Patterns in Software Blogging

In software development, we collect anti-patterns to recognize common traits that lead to poor outcomes. I thought it would be helpful to do the same for software blogging, so I’ve catalogued the most frequent mistakes I see from beginner bloggers.

The most common mistake is meandering. Developers love specificity, so they start blog posts with backstory and historical context. That may be fun to write, but it’s not always interesting to read. From the reader’s perspective, there are a billion other articles they could be reading. Give yourself the title and the first three sentences to answer: Did the author write this for someone like me? How will I benefit from reading it?

Some bloggers write a compelling intro but clutter the reader’s path with extras like a subtitle, a bio, or an image. Everything you put in the reader’s path chips away at their finite supply of focus. Effective teachers compare new concepts to something the reader finds familiar. For example, if you were explaining Jellyfin, you might say, “Jellyfin is a streaming service like Netflix, except it’s open-source and private.” Minimize your assumptions about the reader.

When you write a blog post, think about your target reader. What do they know? Imagine a friend or teammate you know in real life. Write a list of terms they would recognize and terms they would not.

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

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

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

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

সফটওয়্যার ডেভেলপমেন্টে, আমরা খারাপ ফলাফলের দিকে নিয়ে যাওয়া সাধারণ বৈশিষ্ট্যগুলি চিহ্নিত করতে অ্যান্টি-প্যাটার্ন সংগ্রহ করি। আমি ভেবেছিলাম সফটওয়্যার ব্লগিংয়ের জন্যও একই কাজ করা সহায়ক হবে, তাই আমি শিক্ষানবিস ব্লগারদের কাছ থেকে দেখা সবচেয়ে ঘন ঘন ভুলগুলি তালিকাভুক্ত করেছি।

সবচেয়ে সাধারণ ভুল হলো ঘুরে ফিরে বলা। ডেভেলপাররা নির্দিষ্টতা পছন্দ করে, তাই তারা ব্লগ পোস্টগুলি পটভূমি এবং ঐতিহাসিক প্রসঙ্গ দিয়ে শুরু করে। এটি লেখার মজা হতে পারে, কিন্তু পড়ার জন্য সবসময় আকর্ষণীয় নয়। পাঠকের দৃষ্টিকোণ থেকে, আরও কোটি কোটি নিবন্ধ রয়েছে যা তারা পড়তে পারে। নিজেকে শিরোনাম এবং প্রথম তিনটি বাক্য দিন উত্তর দেওয়ার জন্য: লেখক কি আমার মতো কারও জন্য এটি লিখেছেন? এটি পড়ে আমার কী লাভ হবে?

কিছু ব্লগার একটি আকর্ষণীয় ভূমিকা লেখেন কিন্তু উপশিরোনাম, জীবনী বা চিত্রের মতো অতিরিক্ত জিনিস দিয়ে পাঠকের পথ জটিল করে তোলেন। আপনি পাঠকের পথে যা কিছু রাখেন তা তাদের সীমিত মনোযোগের সরবরাহ হ্রাস করে। কার্যকর শিক্ষকরা নতুন ধারণাগুলিকে পাঠকের পরিচিত কোনো কিছুর সাথে তুলনা করেন। উদাহরণস্বরূপ, যদি আপনি Jellyfin ব্যাখ্যা করছেন, আপনি বলতে পারেন, "Jellyfin একটি স্ট্রিমিং পরিষেবা যেমন Netflix, তবে এটি ওপেন-সোর্স এবং ব্যক্তিগত।" পাঠক সম্পর্কে আপনার অনুমানগুলি কমিয়ে দিন।

যখন আপনি একটি ব্লগ পোস্ট লেখেন, আপনার লক্ষ্য পাঠক সম্পর্কে চিন্তা করুন। তারা কী জানে? বাস্তব জীবনে আপনি জানেন এমন একজন বন্ধু বা দলের সদস্যের কল্পনা করুন। তারা যে শর্তাবলী চিনবে এবং যে শর্তাবলী চিনবে না তার একটি তালিকা লিখুন।

In der Softwareentwicklung sammeln wir Anti-Patterns, um gemeinsame Merkmale zu erkennen, die zu schlechten Ergebnissen führen. Ich dachte, es wäre hilfreich, dasselbe für Software-Blogging zu tun, also habe ich die häufigsten Fehler katalogisiert, die ich bei Anfänger-Bloggern sehe.

Der häufigste Fehler ist das Abschweifen. Entwickler lieben Spezifität, also beginnen sie Blogbeiträge mit Hintergrundgeschichten und historischem Kontext. Das zu schreiben mag Spaß machen, aber es ist nicht immer interessant zu lesen. Aus der Perspektive des Lesers gibt es eine Milliarde anderer Artikel, die er lesen könnte. Gib dir selbst den Titel und die ersten drei Sätze, um zu beantworten: Hat der Autor dies für jemanden wie mich geschrieben? Wie werde ich vom Lesen profitieren?

Manche Blogger schreiben eine überzeugende Einleitung, überladen aber den Weg des Lesers mit Extras wie einem Untertitel, einer Biografie oder einem Bild. Alles, was du in den Weg des Lesers stellst, zehrt an seinem begrenzten Vorrat an Konzentration. Effektive Lehrer vergleichen neue Konzepte mit etwas, das dem Leser vertraut ist. Zum Beispiel, wenn du Jellyfin erklären würdest, könntest du sagen: „Jellyfin ist ein Streaming-Dienst wie Netflix, nur dass er Open-Source und privat ist.“ Minimiere deine Annahmen über den Leser.

Wenn du einen Blogbeitrag schreibst, denke an deinen Ziel-Leser. Was wissen sie? Stell dir einen Freund oder Teamkollegen vor, den du im wirklichen Leben kennst. Schreibe eine Liste von Begriffen, die sie erkennen würden, und Begriffen, die sie nicht erkennen würden.

En el desarrollo de software, recopilamos antipatrones para reconocer rasgos comunes que conducen a malos resultados. Pensé que sería útil hacer lo mismo para los blogs de software, así que he catalogado los errores más frecuentes que veo en los blogueros principiantes.

El error más común es divagar. A los desarrolladores les encanta la especificidad, por lo que comienzan las publicaciones del blog con antecedentes e contexto histórico. Eso puede ser divertido de escribir, pero no siempre es interesante de leer. Desde la perspectiva del lector, hay mil millones de otros artículos que podrían estar leyendo. Date el título y las primeras tres oraciones para responder: ¿El autor escribió esto para alguien como yo? ¿Cómo me beneficiaré al leerlo?

Algunos blogueros escriben una introducción convincente pero saturan el camino del lector con extras como un subtítulo, una biografía o una imagen. Todo lo que pongas en el camino del lector resta valor a su suministro finito de enfoque. Los maestros efectivos comparan conceptos nuevos con algo que el lector encuentra familiar. Por ejemplo, si estuvieras explicando Jellyfin, podrías decir: "Jellyfin es un servicio de transmisión como Netflix, excepto que es de código abierto y privado". Minimiza tus suposiciones sobre el lector.

Cuando escribas una publicación de blog, piensa en tu lector objetivo. ¿Qué saben? Imagina a un amigo o compañero de equipo que conoces en la vida real. Escribe una lista de términos que reconocerían y términos que no.

Dans le développement logiciel, nous collectons des anti-patrons pour reconnaître les traits communs qui mènent à de mauvais résultats. J'ai pensé qu'il serait utile de faire de même pour les blogs logiciels, j'ai donc catalogué les erreurs les plus fréquentes que je vois chez les blogueurs débutants.

L'erreur la plus courante est de divaguer. Les développeurs aiment la spécificité, donc ils commencent les articles de blog par des histoires de fond et un contexte historique. Cela peut être amusant à écrire, mais ce n'est pas toujours intéressant à lire. Du point de vue du lecteur, il y a un milliard d'autres articles qu'il pourrait lire. Donnez-vous le titre et les trois premières phrases pour répondre : L'auteur a-t-il écrit ceci pour quelqu'un comme moi ? Comment vais-je bénéficier de sa lecture ?

Certains blogueurs écrivent une introduction convaincante mais encombrent le chemin du lecteur avec des extras comme un sous-titre, une biographie ou une image. Tout ce que vous mettez sur le chemin du lecteur gruge son stock limité de concentration. Les enseignants efficaces comparent les nouveaux concepts à quelque chose de familier au lecteur. Par exemple, si vous expliquiez Jellyfin, vous pourriez dire : « Jellyfin est un service de streaming comme Netflix, sauf qu'il est open-source et privé. » Minimisez vos hypothèses sur le lecteur.

Quand vous écrivez un article de blog, pensez à votre lecteur cible. Que sait-il ? Imaginez un ami ou un coéquipier que vous connaissez dans la vraie vie. Écrivez une liste de termes qu'il reconnaîtrait et de termes qu'il ne reconnaîtrait pas.

सॉफ्टवेयर विकास में, हम खराब परिणामों की ओर ले जाने वाले सामान्य लक्षणों को पहचानने के लिए एंटी-पैटर्न एकत्र करते हैं। मैंने सोचा कि सॉफ्टवेयर ब्लॉगिंग के लिए भी ऐसा करना उपयोगी होगा, इसलिए मैंने शुरुआती ब्लॉगर्स से देखी जाने वाली सबसे लगातार गलतियों को सूचीबद्ध किया है।

सबसे आम गलती भटकना है। डेवलपर्स विशिष्टता पसंद करते हैं, इसलिए वे ब्लॉग पोस्ट को पृष्ठभूमि और ऐतिहासिक संदर्भ से शुरू करते हैं। यह लिखने में मजेदार हो सकता है, लेकिन पढ़ने में हमेशा दिलचस्प नहीं होता। पाठक के दृष्टिकोण से, अरबों अन्य लेख हैं जो वे पढ़ सकते हैं। अपने आप को शीर्षक और पहले तीन वाक्य दें ताकि उत्तर दिया जा सके: क्या लेखक ने यह मेरे जैसे किसी व्यक्ति के लिए लिखा है? मुझे इसे पढ़ने से क्या लाभ होगा?

कुछ ब्लॉगर्स एक सम्मोहक परिचय लिखते हैं लेकिन पाठक के मार्ग को उपशीर्षक, जीवनी या छवि जैसे अतिरिक्त चीजों से अव्यवस्थित करते हैं। आप पाठक के मार्ग पर जो कुछ भी डालते हैं, वह उनके ध्यान की सीमित आपूर्ति को कम करता है। प्रभावी शिक्षक नई अवधारणाओं की तुलना किसी ऐसी चीज़ से करते हैं जो पाठक को परिचित लगती है। उदाहरण के लिए, यदि आप Jellyfin समझा रहे थे, तो आप कह सकते हैं, "Jellyfin एक स्ट्रीमिंग सेवा है जैसे Netflix, सिवाय इसके कि यह ओपन-सोर्स और निजी है।" पाठक के बारे में अपनी धारणाओं को कम करें।

जब आप एक ब्लॉग पोस्ट लिखते हैं, तो अपने लक्षित पाठक के बारे में सोचें। वे क्या जानते हैं? एक ऐसे मित्र या टीम के साथी की कल्पना करें जिसे आप वास्तविक जीवन में जानते हैं। उन शब्दों की एक सूची लिखें जिन्हें वे पहचानेंगे और जिन्हें वे नहीं पहचानेंगे।

Dalam pengembangan perangkat lunak, kami mengumpulkan anti-pola untuk mengenali ciri-ciri umum yang menyebabkan hasil buruk. Saya pikir akan berguna untuk melakukan hal yang sama untuk blogging perangkat lunak, jadi saya telah mengkatalogkan kesalahan paling sering yang saya lihat dari blogger pemula.

Kesalahan paling umum adalah bertele-tele. Pengembang menyukai kekhususan, jadi mereka memulai posting blog dengan cerita latar dan konteks sejarah. Itu mungkin menyenangkan untuk ditulis, tetapi tidak selalu menarik untuk dibaca. Dari perspektif pembaca, ada miliaran artikel lain yang bisa mereka baca. Berikan diri Anda judul dan tiga kalimat pertama untuk menjawab: Apakah penulis menulis ini untuk seseorang seperti saya? Bagaimana saya akan mendapat manfaat dari membacanya?

Beberapa blogger menulis pengantar yang menarik tetapi mengacaukan jalan pembaca dengan tambahan seperti subjudul, biografi, atau gambar. Segala sesuatu yang Anda tempatkan di jalan pembaca menggerogoti persediaan fokus mereka yang terbatas. Guru yang efektif membandingkan konsep baru dengan sesuatu yang akrab bagi pembaca. Misalnya, jika Anda menjelaskan Jellyfin, Anda mungkin berkata, "Jellyfin adalah layanan streaming seperti Netflix, kecuali itu open-source dan pribadi." Minimalkan asumsi Anda tentang pembaca.

Ketika Anda menulis posting blog, pikirkan tentang pembaca target Anda. Apa yang mereka ketahui? Bayangkan seorang teman atau rekan tim yang Anda kenal di kehidupan nyata. Tulis daftar istilah yang akan mereka kenali dan istilah yang tidak akan mereka kenali.

ソフトウェア開発では、悪い結果につながる共通の特徴を認識するためにアンチパターンを収集します。ソフトウェアブログでも同じことをするのが役立つと思ったので、初心者ブロガーから見られる最も頻繁な間違いをカタログ化しました。

最もよくある間違いは、話がそれることです。開発者は具体性を好むため、ブログ記事を背景ストーリーや歴史的コンテキストから始めます。書くのは楽しいかもしれませんが、読むのに常に面白いとは限りません。読者の視点からは、読める記事は他にも何十億もあります。タイトルと最初の3文を使って、次の質問に答えてください：著者は私のような人のためにこれを書いたのか？読むことでどのような利益を得られるのか？

一部のブロガーは魅力的な導入部を書きますが、サブタイトル、経歴、画像などの追加要素で読者の道を散らかします。読者の道に置くものはすべて、彼らの限られた集中力を削ります。効果的な教師は、新しい概念を読者にとって馴染みのあるものと比較します。例えば、Jellyfinを説明する場合、「JellyfinはNetflixのようなストリーミングサービスですが、オープンソースでプライベートです」と言うかもしれません。読者についての仮定を最小限にしてください。

ブログ記事を書くときは、ターゲット読者について考えてください。彼らは何を知っていますか？実生活で知っている友人やチームメイトを想像してください。彼らが認識する用語と認識しない用語のリストを書いてください。

No desenvolvimento de software, coletamos antipadrões para reconhecer características comuns que levam a resultados ruins. Pensei que seria útil fazer o mesmo para blogs de software, então cataloguei os erros mais frequentes que vejo em blogueiros iniciantes.

O erro mais comum é divagar. Os desenvolvedores adoram especificidade, então começam as postagens do blog com histórias de fundo e contexto histórico. Isso pode ser divertido de escrever, mas nem sempre é interessante de ler. Da perspectiva do leitor, existem bilhões de outros artigos que eles poderiam estar lendo. Dê a si mesmo o título e as primeiras três frases para responder: O autor escreveu isso para alguém como eu? Como vou me beneficiar ao ler isso?

Alguns blogueiros escrevem uma introdução convincente, mas sobrecarregam o caminho do leitor com extras como um subtítulo, uma biografia ou uma imagem. Tudo o que você coloca no caminho do leitor consome seu suprimento finito de foco. Professores eficazes comparam novos conceitos a algo familiar ao leitor. Por exemplo, se você estivesse explicando Jellyfin, poderia dizer: "Jellyfin é um serviço de streaming como Netflix, exceto que é open-source e privado." Minimize suas suposições sobre o leitor.

Quando você escreve uma postagem de blog, pense no seu leitor-alvo. O que eles sabem? Imagine um amigo ou colega de equipe que você conhece na vida real. Escreva uma lista de termos que eles reconheceriam e termos que não reconheceriam.

В разработке программного обеспечения мы собираем антипаттерны, чтобы распознавать общие черты, ведущие к плохим результатам. Я подумал, что было бы полезно сделать то же самое для блогинга о программном обеспечении, поэтому я каталогизировал наиболее частые ошибки, которые я вижу у начинающих блогеров.

Самая распространенная ошибка — это отклонение от темы. Разработчики любят конкретику, поэтому они начинают посты в блоге с предыстории и исторического контекста. Это может быть весело писать, но не всегда интересно читать. С точки зрения читателя, есть миллиарды других статей, которые они могли бы читать. Дайте себе заголовок и первые три предложения, чтобы ответить: Написал ли автор это для кого-то вроде меня? Какую пользу я получу от его прочтения?

Некоторые блогеры пишут убедительное введение, но загромождают путь читателя дополнительными элементами, такими как подзаголовок, биография или изображение. Все, что вы ставите на пути читателя, истощает его ограниченный запас концентрации. Эффективные учителя сравнивают новые концепции с чем-то знакомым читателю. Например, если бы вы объясняли Jellyfin, вы могли бы сказать: «Jellyfin — это стриминговый сервис, как Netflix, за исключением того, что он с открытым исходным кодом и приватный». Минимизируйте свои предположения о читателе.

Когда вы пишете пост в блоге, думайте о своей целевой аудитории. Что они знают? Представьте друга или товарища по команде, которого вы знаете в реальной жизни. Напишите список терминов, которые они узнают, и терминов, которые они не узнают.

在软件开发中，我们收集反模式来识别导致不良结果的常见特征。我认为对软件博客做同样的事情会很有帮助，所以我整理了我从初学者博主那里看到的最常见错误。

最常见的错误是漫无边际。开发者喜欢具体性，所以他们从背景故事和历史背景开始写博客文章。这写起来可能很有趣，但读起来并不总是有趣。从读者的角度来看，他们可以阅读的其他文章有数十亿篇。给自己标题和前三句话来回答：作者是为像我这样的人写的吗？我读它会有什么好处？

一些博主写了引人入胜的介绍，但用副标题、个人简介或图片等额外内容使读者的路径变得杂乱。你放在读者路径上的每样东西都会消耗他们有限的注意力。有效的教师会将新概念与读者熟悉的事物进行比较。例如，如果你在解释Jellyfin，你可能会说：“Jellyfin 是一个像Netflix这样的流媒体服务，只是它是开源和私密的。”尽量减少你对读者的假设。

当你写博客文章时，想想你的目标读者。他们知道什么？想象一个你在现实生活中认识的朋友或队友。列出他们能识别的术语和他们不能识别的术语。