Article original : Technical Blogging Basics – How to Write Articles as a Developer

Les développeurs de logiciels travaillent sur la conception, le codage, les tests et la livraison des logiciels que nous utilisons tous les jours. Et quelle que soit la spécialité particulière de ce développeur, ils en savent beaucoup sur beaucoup de choses – ce qui signifie qu'ils devraient partager ces connaissances.

Publier des articles et créer du contenu vidéo sont d'excellents moyens de partager ce que nous apprenons en tant que développeurs. Vous pouvez avoir votre propre blog ou écrire pour une publication. Dans les deux cas, vous devez suivre des processus spécifiques pour bien écrire et vous sentir bien à ce sujet.

Cet article couvrira les fondamentaux du blogging pour vous aider à écrire de grands articles tout en ne lâchant pas la balle en tant que développeur.

TL;DR

Ce tweet résume la plupart des points à un niveau élevé. Cependant, nous parlerons de certaines expériences de la vie réelle et d'apprendre à bloguer plus en détail. Veuillez continuer à lire et profiter.

Connaître votre objectif

Image Connaître votre objectif

Nous avons tous besoin d'un objectif lorsque nous commençons quelque chose et de la motivation pour le continuer. L'intention derrière nos actions et notre motivation peuvent être différentes pour chacun. Vous devez trouver votre intention ou objectif qui explique pourquoi vous voulez commencer un blog ou partager votre contenu.

Dans la plupart des cas, la réponse simple pourrait être Passion. C'est bien ! Cela pourrait aussi être une stratégie commerciale, ou peut-être voulez-vous enseigner aux autres. Peut-être voulez-vous continuer à apprendre – pratiquement tout ce qui vous fait commencer fonctionnera.

En tant que développeur, nous apprenons quelque chose de nouveau tout le temps. Il est presque impossible de mémoriser chaque morceau de ce que nous avons appris. Lorsque nous documentons ces leçons et ces morceaux d'information, nous pourrions aussi bien rendre ces connaissances réutilisables.

C'est pourquoi écrire un article sur quelque chose que vous avez appris récemment est une excellente idée, et vous donne une intention très claire pour votre documentation progressive.

💡 Conseils : Créez un dépôt GitHub privé avec un fichier markdown. Lorsque vous rencontrez quelque chose de nouveau, ajoutez une note à ce sujet (avec du code, si nécessaire) dans le fichier.

Le contenu de ce fichier deviendra alors une excellente source pour vos futurs articles. Je maintient un fichier appelé TIL_2021.md (Choses que j'ai apprises en 2021) dans le même but.

Lorsque j'ai décidé de me lancer dans le blogging, j'avais l'intention d'apprendre en partageant des connaissances. Si vous voulez apprendre quelque chose en profondeur, commencez à l'enseigner. Le blogging est un excellent moyen de le faire.

Trouver votre motivation

Image Ne pas abandonner, rester motivé

La motivation peut faire des merveilles lorsque vous l'avez, mais il peut être difficile de continuer sans elle. En tant que créateur de contenu, votre plus grande motivation est probablement d'entendre les retours de vos lecteurs. Les retours positifs et les critiques constructives vous aident toujours à améliorer le contenu que vous créez.

Mais il y a un problème. Au début, vous n'aurez peut-être pas beaucoup de lecteurs pour vous donner des retours. Les chances de déception sont plus élevées si vous êtes un blogueur individuel. Il est donc utile d'avoir beaucoup d'auto-motivation pour soutenir et continuer votre travail.

Rappelez-vous – ne pas abandonner, rester motivé. En tant que développeur, vous avez beaucoup à apprendre, à partager et à écrire.

💡 Conseils : Si vous voulez commencer à bloguer en tant que développeur, la communauté des développeurs est utile pour rester connecté et motivé. Il existe de nombreuses communautés incroyables comme Hashnode, Dev.to, Codenewbie, Hackernoon, freeCodeCamp, GirlsWhoCode, et bien d'autres.

Faire vos recherches

Image La recherche est la clé. Le contenu est roi.

Dans le blogging, le contenu est roi. En tant que développeurs, nous pouvons avoir plusieurs idées, des étapes de résolution de problèmes et de nouvelles leçons que nous voulons noter. Mais la partie la plus cruciale est de pouvoir en faire du contenu de qualité. Il est généralement nécessaire de prendre le temps requis pour rechercher votre sujet de manière approfondie.

Prenons un exemple de recherche de contenu ici. Supposons que vous avez résolu un problème en utilisant une Linked List, et que c'est la première fois que vous en utilisez une. Vous êtes si excité que vous voulez partager ce que vous avez appris. Voici quelques points à considérer :

  • Vous devez comprendre Linked List de manière générique et au-delà du contexte du problème que vous avez résolu.
  • Vous devez comprendre les avantages et les inconvénients de l'utilisation de Linked List.
  • Vous devez mettre en place quelques exemples qui démontrent comment l'utiliser au mieux.
  • Vous devez vous assurer d'expliquer clairement la manière dont vous avez résolu le problème afin que les gens puissent l'utiliser dans leurs propres cas d'utilisation.

💡 Conseils : Une fois que vous avez compris ce que vous devez savoir, vous pouvez en apprendre davantage à partir de toute ressource bien établie. Effectuez une recherche avec Google, Quora, Reddit, et ainsi de suite. Stackoverflow est une autre excellente plateforme pour vérifier les informations sur le sujet également.

Assurez-vous de noter ce que vous apprenez au fur et à mesure que vous progressez. Ces notes se transformeront finalement en l'article que vous écrivez et publiez.

Planifier la structure du contenu

Image Planifier la structure du contenu

Une fois que vous avez terminé vos recherches de contenu, la prochaine chose à faire est de planifier la structure de l'article. Un excellent contenu d'article peut être ignoré par les lecteurs si vous avez une structure de contenu inadéquate et désordonnée.

Voici quelques conseils pour vous aider à structurer votre contenu d'article de manière lisible :

  • Titre : Un titre accrocheur peut aider à influencer de nombreux lecteurs à visiter votre article. Quoi qu'il en soit, les gens ne manquent presque jamais de lire le titre de l'article. Le rendre accrocheur augmentera le trafic vers votre contenu.
  • Image de couverture : Une image de couverture pertinente rend votre article très attrayant. Lorsque vous partagez vos articles sur les réseaux sociaux comme Twitter, Linkedin ou Reddit, une image de couverture créative peut attirer vos lecteurs.
  • Introduction : cette section décrit le contenu à un niveau élevé. Il peut s'agir d'un paragraphe initial ou d'une section Tl;DR expliquant ce que vous prévoyez de couvrir dans l'article.
  • Titres et sous-titres : Vous devez diviser le contenu en sous-sujets logiques. Pour ce faire, créez des sections et fournissez des titres et sous-titres pertinents. Par exemple, j'ai créé plusieurs sections avec des titres comme Connaître votre objectif, Trouver votre motivation, et ainsi de suite dans cet article.
  • Graphiques : "Une image vaut mille mots." Cela est souvent vrai, alors pensez à soutenir votre contenu avec des graphiques, des images, et ainsi de suite.
  • Résumé : Une section de résumé à la fin aide votre lecteur à récapituler ce qu'il a appris de l'article jusqu'à présent. Cela est également utile pour un lecteur qui revient pour se rappeler le contenu en parcourant le résumé.
  • Liens importants : Vous pouvez vouloir terminer votre article avec une liste de liens connexes pour une lecture supplémentaire. Vous pouvez utiliser la même section pour lister les liens vers vos articles précédemment publiés.

💡 Conseils : Essayez d'utiliser une structure de contenu cohérente pour vos articles. Vos lecteurs s'y habitueront et la trouveront facile à suivre.

Outils d'écriture

Image Utiliser des outils pour vous rendre efficace et plus intelligent

Créer du contenu de qualité prend du temps. Vous pouvez vous rendre productif et efficace en tant que créateur de contenu en utilisant certains des outils disponibles gratuitement. En voici quelques-uns que vous pourriez trouver utiles,

⚒️ Notion : cet outil peut vous aider à gérer vos tâches personnelles et professionnelles de manière efficace. Chaque fois qu'une idée d'article vous vient ou que vous résolvez un problème intéressant, créez une tâche dans l'outil. Vous pouvez prioriser, planifier et assigner des tâches avec facilité.

Image Planificateur de tâches avec Notion

⚒️ Grammarly : Si vous êtes un locuteur non natif de l'anglais comme moi, il y a des moments où vous ne connaissez peut-être pas assez les règles de grammaire de la langue.

Dans ce cas, un outil comme Grammarly est un sauveur de vie à bien des égards. Il détecte les erreurs grammaticales et d'orthographe, suggère de reformuler les phrases complexes, corrige la voix passive en voix active, et plus encore. Vous pouvez commencer avec la version gratuite et opter pour la version premium en fonction de votre utilisation.

Image Suggestions de correction avec Grammarly

⚒️ Hemingway Editor : C'est un autre excellent outil pour vous aider avec votre écriture en anglais. Vous pouvez utiliser cet éditeur avec Grammarly si vous le souhaitez. J'aime la façon dont il indique l'utilisation inadéquate des adverbes, de la voix active/passive, et des mots et phrases compliqués.

Image Suggestions catégorisées avec l'éditeur Hemmingway

⚒️ Canva : Canva est un outil où vous créez des designs, de l'art, et libérez votre créativité. Vous pouvez créer des images de couverture, des graphiques d'articles, des gifs animés, et plus encore sans aucune expérience préalable avec Canva. Le plan gratuit généreux est suffisant pour commencer.

Image Créez et organisez votre créativité en utilisant Canva

⚒️ Pixteller : C'est une suggestion alternative pour créer des images de couverture, des graphiques, et ainsi de suite.

Image Pixteller pour créer des images

⚒️ ShareX : C'est un outil de productivité super cool pour les captures d'écran, la création d'images animées, le partage de fichiers, et ainsi de suite.

Image Créez des gifs, des captures d'écran, des vidéos

⚒️ OBS Studio : c'est un outil gratuit et open-source d'enregistrement et de streaming vidéo. Vous vous demandez peut-être pourquoi j'ai besoin de cela pour le blogging ?

Parfois, vous pouvez vouloir créer une vidéo, la télécharger sur YouTube ou Vimeo, et la lier à partir de vos articles. Vous pouvez utiliser l'outil OBS Studio pour créer des vidéos de qualité avec de nombreuses options de personnalisation.

Image Créez des vidéos de haute qualité

⚒️ Générateur de snippet SERP : SERP (Search Engine Result Page) est la page que nous voyons après avoir saisi une requête dans des moteurs de recherche comme Google ou Bing. Un générateur de snippet SERP vous aide à finaliser un titre et une méta-description appropriés pour votre article avant de le publier.

Voir l'image ci-dessous pour déterminer un titre et une description dans une limite afin d'afficher correctement le résultat de la recherche.

Image Générateur SERP

Faire beaucoup de relecture

Image Revoir, re-revoir, re-re-revoir, et ainsi de suite...

Lorsque vous écrivez quelque chose, vous devez vérifier les erreurs et faire relire votre article avant de le publier ou de le partager. Ce processus de vérification et de s'assurer que votre contenu est prêt à être publié s'appelle la relecture. En général, vous devez vérifier :

  • Les erreurs d'orthographe
  • Les erreurs grammaticales
  • Les problèmes de formatage
  • La ponctuation
  • L'exactitude
  • La cohérence de la langue

En ce qui concerne la relecture et la révision, voici une citation célèbre pour vous inspirer :

« J'ai trouvé que la meilleure façon de réviser son propre travail est de faire semblant que quelqu'un d'autre l'a écrit et ensuite de le critiquer sévèrement. » – Don Roff

Publier votre article

Image Ne le gardez pas pour vous, publiez-le simplement

Si vous êtes satisfait de l'article après votre relecture, l'étape logique suivante est de le publier. Vous pouvez vouloir le planifier pour qu'il soit publié un jour particulier de la semaine, ou vous pouvez vouloir le publier immédiatement – c'est à vous de décider.

En tant que principe général, il est préférable de publier lorsqu'un article est prêt de votre côté. De même, vous ne devriez jamais vous précipiter pour publier un article afin de respecter une date limite.

💡 Conseils : La publication de votre article devrait faire partie de l'ensemble du plan. Si vous devez publier un article à une date spécifique, travaillez à rebours pour planifier le contenu en conséquence. Ne compromettez pas la qualité du contenu dans la précipitation de le publier.

Partager votre article sur les réseaux sociaux

Image Les plateformes de réseaux sociaux sont un grand booster

Les réseaux sociaux sont un outil extrêmement puissant. Et vous devriez en faire un usage positif en tant que blogueur.

Publier votre article peut ne pas suffire si vous voulez qu'il atteigne autant de lecteurs potentiels que possible. Il est donc bon de partager votre article sur diverses plateformes de réseaux sociaux.

Voici quelques plateformes où vous devriez partager les liens de vos articles :

Il existe quelques autres plateformes où le partage de liens seul peut ne pas très bien fonctionner. Vous pouvez créer une image de couverture/graphique adaptée au sujet et télécharger l'image (et partager le lien) sur des plateformes comme Instagram et Pinterest en utilisant les bons hashtags.

💡 Conseils : Assurez-vous de suivre les politiques et les directives spécifiées par chaque plateforme de réseau social lorsque vous partagez le lien de votre blog. Si vous ne le faites pas, votre compte pourrait être signalé ou banni.

Une autre façon passionnante de partager votre contenu est de le republier. Vous pouvez republier votre article sur une autre plateforme de blogging si vous êtes autorisé à le faire. Par exemple, un article écrit sur la plateforme Hashnode peut être republié sur la plateforme Dev.to et vice-versa.

💡 Conseils : Vous pouvez définir l'URL canonique vers le lien de l'article original lorsque vous le republiez. C'est un moyen d'indiquer aux moteurs de recherche comme Google quelle est la copie originale du contenu et d'éliminer le contenu dupliqué.

Bonnes plateformes de blogging

Image Une plateforme de blogging pour vous lancer

D'accord, maintenant nous savons comment écrire un article et le partager pour que d'autres puissent le lire. Maintenant, apprenons quelques plateformes de blogging où vous pouvez commencer.

Voici quelques plateformes pour commencer à bloguer et grandir en tant que membre de la communauté.

Il existe de nombreuses publications et organisations qui embauchent et paient les créateurs de contenu. En tant que développeur-blogueur, cela peut ouvrir de nombreuses opportunités de freelance et vous permettre d'être rémunéré pour le partage de votre contenu. Vous pouvez également contribuer à la documentation open-source et à d'autres projets.

En résumé

Pour résumer,

  • Le blogging en tant que développeur est gérable en tant qu'activité secondaire sans compromettre votre production de travail.
  • Les problèmes que vous avez résolus et vos recherches sur Google, Quora et Stackoverflow pourraient être une source utile d'idées d'écriture.
  • Trouvez votre objectif avant de commencer un blog et d'écrire des articles. L'intention derrière votre travail peut être triviale ou plus significative – les deux sont bien.
  • Restez motivé.
  • Utilisez les bons outils pour vous rendre productif en tant qu'écrivain.
  • Planifiez la structure de votre contenu, relisez vos articles et publiez-les.
  • Utilisez les réseaux sociaux comme un outil pour partager vos articles.
  • Il existe des plateformes de blogging fantastiques. Essayez-les et faites partie des communautés de développeurs.
  • Continuez à apprendre, à écrire et à partager.

Avant de terminer...

J'espère que vous avez trouvé cet article perspicace et qu'il vous aidera à commencer à utiliser ces concepts de manière plus efficace dans le blogging.

Restez connectés. Vous me trouverez actif sur Twitter (@tapasadhikary). N'hésitez pas à me suivre.

Vous pourriez également aimer ces articles :