43 points par GN⁺ 2025-03-31 | 1 commentaires | Partager sur WhatsApp
  • Un guide pratique sur la façon d’écrire des articles de blog que les développeurs lisent réellement et partagent
  • L’auteur s’appuie sur 9 ans d’expérience en blogging logiciel et sur des millions de vues pour analyser la différence entre les publications qui réussissent et celles qui échouent
  • Il explique les points communs et les stratégies des articles qui attirent l’attention dans des communautés de développeurs comme Hacker News, Reddit et Lobsters

Pourquoi faire confiance à l’auteur

  • L’auteur tient un blog personnel de développement depuis 9 ans, avec 300 000 à 500 000 lecteurs par an
  • Il est apparu plus de 30 fois en première page de Hacker News, dont plusieurs fois à la 1re place
  • Un seul billet de blog lui a permis de lancer une activité indie rentable
  • Il est aussi régulièrement mentionné sur Reddit et Lobsters
  • Son blog est considéré comme le 48e blog personnel le plus populaire sur Hacker News

Aller vite à l’essentiel

  • Beaucoup de blogueurs développeurs n’entrent pas assez vite dans le vif du sujet, ce qui pousse les lecteurs à partir
  • En commençant un article, les lecteurs attendent des réponses à deux questions :
    • Cet article est-il fait pour quelqu’un comme moi ?
    • Qu’est-ce que j’y gagne en le lisant ?
  • Ces deux questions doivent trouver une réponse dans le titre et dans les 3 premières phrases
  • Il faut employer des thèmes et des termes qui intéressent le lecteur, et éviter le jargon excessif ou les longues explications de contexte
  • Le bénéfice apporté par l’article peut être, par exemple :
    • une technique directement applicable dans la vie quotidienne ou au travail
    • une explication de concept facile à comprendre
    • un éclairage sur une technologie ou un secteur
    • une histoire intéressante à laquelle on peut s’identifier
  • Exemple : “if got, want: A Simple Way to Write Better Go Tests”

    • Dès le titre et la première phrase, les éléments suivants sont clairs :
      • public visé : les utilisateurs du langage Go
      • bénéfice : apprendre une nouvelle manière d’écrire des tests en 30 secondes

Comment élargir son public cible

  • La plupart des blogueurs écrivent pour une petite niche de développeurs (par exemple, des développeurs Java intermédiaires ou confirmés)
  • Avec de légers ajustements de formulation, on peut toucher un public bien plus large (par exemple : tous les développeurs Java → tous les développeurs → les personnes intéressées par la tech)
  • En adaptant légèrement les termes et les explications pour que des lecteurs sans connaissances préalables puissent comprendre, on peut multiplier sa portée par 10
  • Attention toutefois : à trop généraliser, on risque de perdre en profondeur ou en technicité
  • Exemple : “How I Stole Your Siacoin”

    • À l’origine, c’était un article destiné à une communauté crypto très spécifique,
    • mais les termes et explications ont été généralisés pour qu’il soit compréhensible même par des lecteurs ne connaissant pas les cryptomonnaies
    • résultat : l’article est devenu populaire dans diverses communautés, dont Reddit et Hacker News

Planifier les chemins d’accès jusqu’au lecteur

  • Même si un article est bien écrit, cela ne sert à rien si personne ne le lit
  • Il vaut mieux éviter les sujets qui ont peu de chances d’apparaître en bonne position dans les résultats Google
  • Il faut un plan réaliste pour partager l’article dans des communautés comme Reddit ou Hacker News
  • Sur Reddit, par exemple, les liens externes sont souvent interdits ou soumis à des règles strictes
  • Hacker News est souvent peu réceptif aux tutoriels ou aux sujets trop rebattus
  • Même sur les réseaux sociaux, l’impact reste faible si l’on n’a pas beaucoup d’abonnés
  • Il faut concevoir un chemin réaliste

    • Avant même de choisir un sujet, il faut réfléchir à la manière dont l’article pourra atteindre ses lecteurs
    • Questions à se poser :
      • Est-ce un sujet facile à trouver via Google ?
      • S’agit-il d’un sujet sur lequel il existe déjà des centaines d’articles ?
      • Quels mots-clés le public visé utilisera-t-il dans ses recherches ?
      • Existe-t-il une communauté où partager le lien ? Cette communauté est-elle active ?
  • Exemple : “Using Zig to Unit Test a C Application”

    • Zig étant une technologie émergente, il y avait très peu d’articles concurrents, ce qui a permis un bon classement dans les recherches
    • Le lien pouvait être partagé sur Hacker News, Lobsters, Reddit (/r/Zig), Ziggit, etc.
    • Résultat : l’article est devenu l’un des plus populaires sur tous ces canaux

Montrer davantage d’éléments visuels

  • Le changement le plus efficace dans un billet de blog consiste à ajouter des images
  • Un article composé uniquement de longs blocs de texte est difficile à lire
  • Dans les cas suivants, il est utile d’insérer des images, captures d’écran, graphiques, etc. :
    • explication d’un programme avec interface graphique → capture d’écran
    • explication d’une évolution chiffrée → graphique
    • récit d’un incident comme une erreur serveur → capture de tableau de bord
    • explication d’un concept complexe → schéma, diagramme
  • Pour des dessins simples, on peut utiliser des outils gratuits comme Excalidraw
  • Faire appel à un illustrateur peut aussi être une bonne idée (environ 50 à 100 $ par illustration)
  • Parfois, un dessin simple fait sous MS Paint est plus efficace qu’une image générée par IA

Concevoir une structure pour les lecteurs qui survolent

  • Beaucoup de lecteurs ne lisent pas un article du début à la fin : ils le parcourent rapidement avant de décider
  • Pour susciter l’intérêt même en lecture en diagonale, les éléments suivants sont importants :
    • des titres clairs et intéressants
    • des images pertinentes et des repères visuels
    • éviter les longs paragraphes composés uniquement de texte
  • Outil : vérifier l’article du point de vue d’un lecteur qui survole

    • On peut utiliser un bookmarklet pour n’afficher que les titres et les images d’un article
    • Cela permet de vérifier la structure telle qu’un lecteur en lecture rapide la perçoit
  • Exemple : article à la structure ennuyeuse vs article captivant

    • “End-to-End Testing Web Apps: The Painless Way” → échec, car les titres et les images n’étaient pas assez attractifs
    • “I Regret My $46k Website Redesign” → succès grâce à une structure visuelle engageante (150 000 lecteurs la première semaine)

1 commentaires

 
GN⁺ 2025-03-31
Avis Hacker News
  • En général, pour écrire un billet de blog, la structure en pyramide inversée est la plus adaptée. Il est important de faire passer rapidement l’idée principale, puis de détailler ensuite. Ainsi, même si le lecteur arrête sa lecture en cours de route, il ne manque pas l’essentiel

    • Pour le problème de trouver des lecteurs, la meilleure solution est de rester transparent. Le format en pyramide inversée y répond. Il ne sert à rien d’attirer des gens qui ne sont pas intéressés. Il est plus important de conserver ses lecteurs existants que d’en attirer de nouveaux
    • Concernant l’usage des images, avis sceptique. Si elles ne sont pas étroitement liées au texte, les illustrations inutiles ne sont pas une bonne idée. Il est important de réduire le bruit visuel. Les images ne doivent absolument pas essayer d’être drôles
  • Avis contraire : écrire un billet de blog pour qu’il soit lu par d’autres fait perdre, pour la plupart des gens, le sens même de l’écriture. La plupart des textes sur le web ne sont pas lus, et écrire dans l’espoir d’être lu n’est pas motivant

    • Écrire reste très précieux et amusant, même si personne ne vous lit. Écrire permet de structurer sa pensée et d’en apprendre davantage sur un sujet et sur soi-même
    • Il vaut mieux écrire sur des sujets intéressants sur son blog personnel. Ne pas installer d’outil d’analyse ; écrire, publier, puis poster sur LinkedIn, et un jour quelqu’un le verra et l’appréciera
  • Demander à une IA d’évaluer de façon critique un billet de blog ou un post Hacker News ou Reddit s’est révélé efficace. Les retours de l’IA ont été étonnants, et cela a permis de réaliser qu’on écrivait comme un auteur

  • Il est bon de suivre la règle : « écris le texte que toi-même tu lirais vraiment ». Notre cerveau nous pousse à croire que ce que nous avons produit est excellent. Il est important de trouver un moyen de regarder son propre texte avec objectivité

    • Écrire un texte que d’autres liront réellement est plus difficile. Si c’est un texte que vous liriez vous-même, il y a de fortes chances que d’autres le lisent aussi
  • Steve Ballmer n’a pas diversifié ses actions Microsoft comme Bill Gates, mais grâce à cela il est devenu plus riche que Gates. Cela dit, il est permis de douter qu’il soit judicieux de tout miser sur une seule entreprise

    • Il est important que l’écriture soit utile à d’autres. Mais diversifier son contenu pour attirer un public plus large aboutit souvent à des textes creux et formatés
    • Hacker News favorise un certain type d’articles. La plupart ne laissent pas de souvenir. On apprend davantage dans les commentaires
    • Écrire sur les sujets sur lesquels on travaille en ce moment ou qui nous intéressent. Rédiger quelque chose qui aurait été utile à son moi passé. Ce n’est pas la même chose qu’écrire pour des lecteurs
  • Il faut personnellement être passionné par ce qu’on écrit. Sinon, les lecteurs le remarqueront et le critiqueront. L’écriture doit être faite pour soi-même

  • Un billet de blog doit-il toujours être court ? Y a-t-il des cas où un texte long est nécessaire ?

  • Les lecteurs de Hacker News sont généralement hostiles aux sujets liés aux cryptomonnaies, et pourtant l’article a atteint la première page

  • Il existe deux façons de faire en sorte qu’un billet de blog soit lu et partagé par des développeurs

    • Écrire beaucoup, jusqu’à finir par tomber sur un billet qui fonctionne
    • Écrire en y mettant de la recherche et des efforts
    • L’auteur privilégie fortement la deuxième approche. Il consacre beaucoup de temps à chaque billet pour en être fier. Il ajuste la structure, cherche à le rendre concis et à améliorer sa lisibilité en lecture rapide
  • Les blogs populaires adoptent souvent une méthode opposée à celle proposée ici. Mais ce sont malgré tout des conseils utiles pour ceux qui cherchent leur style et veulent optimiser leur popularité