La rédaction technique pour les startups est importante : voici pourquoi

Bienvenue dans le premier article de blog de notre nouvelle série, « Comment la rédaction technique peut dynamiser votre startup ».

Dans cette série, je vais vous montrer comment la rédaction technique peut bénéficier aux startups, qu'il s'agisse de gagner en visibilité ou d'instaurer la confiance avec votre public. En tant que fournisseur de services de rédaction auprès de startups, j'ai constaté l'impact positif qu'un contenu bien conçu peut avoir.

Aujourd'hui, je vais commencer par un aperçu de la façon dont la rédaction technique peut stimuler la croissance de votre startup. Restez à l'écoute pour plus d'articles expliquant pourquoi l'écriture est un outil essentiel pour les startups.

La rédaction technique joue un rôle important dans le succès d’une startup. Cela implique de créer une documentation claire, concise et axée sur l'utilisateur qui explique le fonctionnement d'un produit ou d'un service. « Des opinions fortes, mais faiblement défendues. « Exposez-vous, mais restez à la recherche des opinions dissidentes de personnes intelligentes et respectueuses.

Un logiciel d’écriture est à mi-chemin entre l’écriture d’un roman et la construction d’un pont.

La rédaction technique tolère et même encourage les particularités stylistiques que l’édition traditionnelle ne prendrait pas en compte. Penchez-vous sur eux.

Le contenu technique est soit actuel, soit intemporel, avec presque rien entre les deux.

Crédit image – « État des relations avec les développeurs » – vous pouvez accéder au rapport complet ici.

La personne qui rédige le plan dans une organisation/startup possède un pouvoir énorme. Si vous souhaitez trouver les nouveaux venus dans une entreprise technologique, recherchez qui rédige le plan. Même s'ils ne proposent pas toutes les idées, vous saurez qu'ils ont l'énergie, la motivation et les compétences nécessaires pour organiser et communiquer leurs idées sous forme écrite.

Entourez-vous, ainsi que votre startup, de « penseurs latéraux » qui ne peuvent s'empêcher de proposer des perspectives différentes sur tout ce qu'ils voient dans votre produit ou service. Ils n’auront pas toujours raison, mais ils remettent toujours en question votre réflexion et votre écriture.

Investir dans la rédaction technique peut avoir un impact substantiel sur le succès de votre startup. Cela profite non seulement à vos utilisateurs, mais contribue également à l’efficience et à l’efficacité de vos opérations internes. N'oubliez pas que l'objectif est de produire une documentation claire, concise et compréhensible pour votre public cible. En conséquence, la satisfaction des utilisateurs, leur fidélité et la croissance de leur entreprise augmenteront.

N'oubliez pas : les formats multimédias sont cycliques. Nietzsche a écrit des aphorismes et Twitter est un aphorisme en tant que service. Le hip-hop a ramené la poésie. Montaigne a été le pionnier du format d'essai et les blogs les ont remis à la mode.

Les startups devraient rédiger davantage de manifestes, de blogs, de documents propres et de guides d'intégration.

Qu’est-ce que la rédaction technique ?

Au cours des 3 dernières années, j'ai travaillé par intermittence sur de la documentation, des guides d'intégration et des articles de blog techniques pour plus de 20 startups. J'ai commencé à contribuer pendant mon rôle de défenseur des développeurs chez SuperTokens – une alternative à Auth0, Firebase Auth en 2021 et j'ai aidé les développeurs à passer à la nouvelle authentification des utilisateurs open source.

J'ai découvert que j'aimais écrire des blogs et de la documentation techniques . Il est satisfaisant de produire une rédaction technique de haute qualité qui profite aux autres.

J'ai lu beaucoup de ressources de rédaction technique et de documentation au fil des ans. J'ai écrit sur les raisons pour lesquelles chaque ingénieur devrait écrire et j'ai rassemblé mes notes à la fois pour m'aider à me souvenir des points clés plus tard dans ma carrière, mais aussi comme outil pour m'aider à réfléchir à l'écriture maintenant.

GPT a révélé à quel point l’écriture est du pur pablum. Fade, sans vie, inintéressant, inoffensif et ne valant pas le prix de l’encre avec laquelle il a été imprimé. les bons rédacteurs deviendront donc plus importants pour vos startups, capables de créer et d'écrire d'excellents blogs techniques et le plagiat de ChatGPT n'est absolument pas un problème. Si vous ne pouvez pas écrire plus vite qu'une machine, que faites-vous en écrivant ?

Si vous êtes un développeur intéressé par la rédaction de blogs techniques, j'ai écrit un blog dédié complet sur ce qu'est la rédaction technique et comment rédiger de bons blogs techniques .

Mes principes d'écriture

Lorsque je rédige des textes techniques, j'essaie toujours de garder les principes suivants à l'esprit.

• Le but de l’écriture est de rendre les tâches aussi simples et efficaces que possible pour les utilisateurs.
• Les développeurs préfèrent être montrés plutôt que informés et préfèrent apprendre par la pratique.
• Aidez vos utilisateurs à obtenir leur premier succès le plus rapidement possible.
• Restez simple et écrivez dans un langage simple.

Pourquoi la rédaction technique est-elle importante pour les startups ?

J'écris du contenu technique depuis 3 ans. Voici ce que j'ai appris :

• Des blogs et une documentation techniques clairs aident les utilisateurs finaux à comprendre votre produit rapidement et efficacement, réduisant ainsi la frustration et augmentant la satisfaction.

• Une rédaction technique approfondie montre que vous prenez votre produit et vos utilisateurs au sérieux. Cela renforce la confiance de votre marque.

• Les nouveaux utilisateurs finaux peuvent rapidement maîtriser votre produit s’ils ont accès à des guides, à une intégration et à des documents bien organisés et faciles à suivre.

• Des blogs et une documentation techniques bien structurés améliorent le référencement de votre site Web, aidant ainsi les clients potentiels à vous trouver plus facilement.

• À mesure que votre startup se développe, vous devrez intégrer davantage d’employés. Une bonne rédaction et documentation technique est essentielle pour former efficacement les nouvelles recrues.

• Voici quelques exemples d’excellents blogs d’ingénierie :

• Le blog Cloudflare

• Blog d'ingénierie DoorDash

• Le blog technique Netflix

  
  

• Des blogs et une documentation techniques détaillés démontrent que vous disposez d’une stratégie produit et commerciale bien pensée, qui peut intéresser les investisseurs et partenaires potentiels.

• Les commentaires des utilisateurs finaux sur les blogs techniques et la documentation sont souvent inestimables pour améliorer votre produit et identifier les zones de confusion.

• Les blogs et la documentation bien rédigés peuvent être facilement traduits dans d'autres langues locales, vous permettant ainsi d'atteindre un public mondial plus large.

• Avoir des blogs et une documentation techniques de qualité supérieure peut constituer un différenciateur important, vous donnant un avantage sur vos concurrents.

  
  

Bonne rédaction technique = marketing organique des développeurs

Les développeurs ont la réputation d’être opposés au marketing, mais ce n’est pas nécessairement vrai.

En réalité, les développeurs gagnent en pouvoir d’achat et en respect au sein des entreprises de toutes tailles. Les employeurs reconnaissent l'importance d'investir dans des outils pour aider les développeurs à rester productifs et heureux, car les bons développeurs sont difficiles à trouver et à retenir.

La variété des outils de développement a considérablement augmenté, allant des IDE aux abstractions de niveau supérieur et aux services payants comme GPT, y compris les outils low-code.

La rédaction technique est une stratégie marketing de développement réussie, ancrée dans l'authenticité et la compréhension du public. Les startups devraient passer du temps avec les développeurs, à la fois en ligne et en personne, pour comprendre leurs besoins et leurs préférences.

Le contenu technique doit être véritablement utile et éducatif, et il est souvent plus efficace lorsqu'il est créé par un collègue développeur. Les options incluent des ingénieurs internes, des défenseurs des développeurs, des programmes de rédaction communautaires, des rédacteurs indépendants, des ingénieurs logiciels indépendants et des écrivains comme moi .

Les développeurs sont présents sur des plateformes comme X anciennement Twitter, Hacker News, Reddit et LinkedIn et adorent lire des articles de blog techniques bien rédigés.

Pourquoi la stratégie de rédaction technique se démarque-t-elle ?

Même si j'admets que les grandes entreprises technologiques et les startups parviennent de mieux en mieux à atteindre les développeurs. J'ai passé 13 ans en tant qu'ingénieur logiciel et leader technique avant de démarrer mon blog en tant que développeur marketing. Voici donc mes réflexions sur les raisons pour lesquelles la rédaction technique est un atout majeur pour les startups.

Le marketing business-to-developer (« marketing B2D ») décrit les initiatives marketing conçues pour atteindre les développeurs et la rédaction technique est l'un des meilleurs moyens d'y parvenir tout en étant authentique, authentique et intéressante.

De nombreuses startups ont du mal avec le marketing technique B2D car les développeurs sont plus difficiles à atteindre que le consommateur moyen. Les gadgets comme les cadeaux, les coupons alimentaires gratuits, les t-shirts gratuits ou les événements d'exclusion centrés sur l'alcool ne sont pas la solution.

Soyez intéressant - L'écriture est de loin le moyen le plus rapide d'obtenir les commentaires des développeurs en génie logiciel.

Construisez un projet sympa avec votre produit, écrivez à ce sujet et partagez-le en public pour obtenir des commentaires et itérer.

Nous tous, les développeurs apprécions l’honnêteté. Ces derniers temps, j'ai personnellement aimé la page blog de Supabase . Ils ont écrit des blogs très sympas et ont réalisé une très bonne croissance grâce à leur contenu écrit.

En tant que startup, cela signifie que vous devez être honnête à propos de votre produit au sein de la communauté.

De nombreuses grandes entreprises technologiques embauchent des défenseurs des développeurs – des personnes ayant une formation technique qui défendront leur produit lors d'événements en direct.

Les grandes entreprises technologiques comme Google/Amazon/Meta/Netflix disposent d'équipes composées de ces personnes pour donner des conférences lors de conférences, organiser des sessions de formation et rédiger du contenu technique sur les produits de leur entreprise, mais le rôle de défenseur des développeurs ne convient pas à la plupart des startups. parce qu'ils ont dû agir rapidement et malheureusement, de nombreux défenseurs des développeurs sont des gens paresseux et inférieurs à la moyenne.

Les startups ont besoin d'ingénieurs hautement qualifiés en technologie, capables d'écrire et de créer sur leur blog d'ingénierie une plate-forme sur laquelle les gens souhaitent venir chaque semaine, voire chaque jour.

Les startups doivent tirer parti de la rédaction technique et de la documentation comme outils marketing .

Crédit image – « État des relations avec les développeurs » – vous pouvez accéder au rapport complet ici.

Rôle de la rédaction technique dans une communication efficace

Nous pouvons rédiger de nombreux types différents de contenu technique pour les développeurs de logiciels.

• La documentation est importante, mais très peu de startups l'utilisent comme canal de marketing.
• Les didacticiels et les guides pratiques peuvent aider les utilisateurs finaux à comprendre comment utiliser votre produit dans le monde réel.
• Le contenu de sensibilisation est créé dans le but d'augmenter le haut de votre entonnoir et peut être publié sur des sites partenaires externes pour une portée accrue. Hashnode, DevTo, HackerNoon et DZone sont tous des endroits gratuits pour publier du contenu de développeur.
• Les articles de blog sur votre site Web vous permettent d'engager les lecteurs et d'augmenter les inscriptions.
• Parrainez des rédacteurs indépendants ou un ingénieur senior qui rédige un blog technique sur leur site Web ou leurs newsletters.

Comment la rédaction technique garantit la clarté et la compréhension

Écrivez toujours de bons exemples en commençant par du vrai code, cela renforce la confiance avec les clients et les investisseurs lorsque vous écrivez en public.

Mes tactiques pour écrire en public :

Quelqu'un récemment dans mon DM Twitter m'a demandé : « Salut Ankur, je suis un grand fan de votre blog mais j'ai une question : comment gérez-vous l'écriture en public ? Les internautes sont parfois des connards.

J'ai souvent entendu le conseil « Soit éteignez, soit ne lisez pas les commentaires », mais j'ai acquis énormément de connaissances en lisant les commentaires Internet sur mes publications et les publications d'autres personnes par des inconnus au fil des ans, même si parfois les gens sont des connards.

Parlez toujours de faits réels et soyez honnête

Je parle principalement de faits – qu'il s'agisse de faits sur les startups ou de défenseurs des développeurs sur mes expériences en tant qu'écrivain. En général, je dirais que les commentaires des gens sur les faits ont tendance à rester assez normaux. Les principaux types de commentaires négatifs que je reçois sur des faits concernant mes erreurs. J'essaie surtout d'éviter cela en essayant d'être conscient de mon niveau de connaissances sur un sujet et en disant « Je ne suis pas sûr… » lorsque je ne suis pas sûr de quelque chose.

Modifier et refactoriser les erreurs

Je fais beaucoup d’erreurs dans mes articles de blog parce que j’écris sur beaucoup de choses qui sont à la limite de mes connaissances. Lorsque les gens signalent des erreurs, je modifie le billet de blog et le corrige. En règle générale, je reste près d'un ordinateur pendant quelques heures après avoir publié un article de blog sur ma chronologie Twitter ou LinkedIn afin de pouvoir corriger les erreurs rapidement au fur et à mesure qu'elles surviennent.

Combler le déficit de connaissances technologiques : le principal défi du programme de relations avec les développeurs de startups

Le rapport d'enquête mentionne que le développement de contenu était l'une des principales activités professionnelles des praticiens des relations avec les développeurs en 2023, avec une distinction entre le développement de contenu lié à l'éducation (55 %) et le développement de contenu technique, tel que la documentation (50 %)​. Cela souligne l'importance de la rédaction technique et de la création de contenu pour interagir et éduquer les communautés de développeurs.

Les 3 principales questions que chaque startup doit se poser avant de démarrer un blog technique

Créer un blog technique peut être une étape importante pour une startup, car cela nécessite une approche réfléchie pour garantir qu'il répond efficacement à son objectif.

Posez ces questions si vous démarrez un nouveau blog pour votre startup.

• le but de l'écriture

• le public ciblé

• le type de contenu à créer

  
  

Identifier l'objectif du blog est crucial, qu'il s'agisse d'accroître la notoriété de la marque, de compléter la documentation, de développer une audience ou d'établir un leadership éclairé. Deuxièmement, comprendre et affiner l’audience permet d’adapter le contenu en conséquence. Enfin, décider du format du contenu, qu'il s'agisse de didacticiels, de résumés, d'études de cas, de fonctionnalités, de questions-réponses, de comparaisons ou d'articles d'opinion, aide à maintenir un blog cohérent et attrayant.

C'est tout pour ce blog. Je continuerai à écrire sur ce sujet et partagerai plus d'informations sur des fonctionnalités plus spécifiques dans le prochain blog.

Restez à l'écoute D'ici là, voici quelques-uns de mes blogs les plus populaires que vous aimeriez peut-être lire.

• Développeurs de logiciels, pourquoi n'avez-vous pas encore commencé la rédaction technique ?
• Comment créer des microservices évolutifs avec amplification
• Comment utiliser les fonctions personnalisées de HarperDB

Au plaisir de partager davantage sur le pouvoir de la rédaction technique dans un prochain article.