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.
Source: Hacker News · Résumé par HeadlinesBriefing