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 auprès de startups, j'ai constaté l'impact positif qu'un contenu bien conçu peut avoir. services de rédaction 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. « « Exposez-vous, mais restez à la recherche des opinions dissidentes de personnes intelligentes et respectueuses. Des opinions fortes, mais faiblement défendues. 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. complet Crédit image – « État des relations avec les développeurs » – vous pouvez accéder au rapport 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 chez Auth en 2021 et j'ai aidé les développeurs à passer à la nouvelle authentification des utilisateurs open source. de défenseur des développeurs SuperTokens – une alternative à Auth0, Firebase J'ai découvert que j'aimais écrire . Il est satisfaisant de produire de haute qualité qui profite aux autres. des blogs et de la documentation techniques une rédaction technique https://twitter.com/TheAnkurTyagi/status/1715444967173218413?embedable=true J'ai lu beaucoup de ressources de rédaction technique et de documentation au fil des ans. J'ai écrit sur 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. les raisons pour lesquelles chaque ingénieur devrait écrire 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. https://twitter.com/GergelyOrosz/status/1610695967715610624?embedable=true 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 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. blog Le marketing business-to-developer (« marketing B2D ») décrit et la rédaction technique est l'un des meilleurs moyens d'y parvenir tout en étant authentique, authentique et intéressante. les initiatives marketing conçues pour atteindre les développeurs 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. De nombreuses startups ont du mal avec le marketing technique B2D car les développeurs sont plus difficiles à atteindre que le consommateur moyen. 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 . Ils ont écrit des blogs très sympas et ont réalisé une très bonne croissance grâce à leur contenu écrit. Supabase 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 personnes ayant une formation technique qui défendront leur produit lors d'événements en direct. des défenseurs des développeurs Les grandes entreprises technologiques comme 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. Google/Amazon/Meta/Netflix 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 complet Crédit image – « État des relations avec les développeurs » – vous pouvez accéder au rapport 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. est importante, mais très peu de startups l'utilisent comme canal de marketing. La documentation peuvent aider les utilisateurs finaux à comprendre comment utiliser votre produit dans le monde réel. Les didacticiels et les guides pratiques 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. Le contenu de sensibilisation sur votre site Web vous permettent d'engager les lecteurs et d'augmenter les inscriptions. Les articles de blog 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 « », 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. Soit éteignez, soit ne lisez pas les commentaires 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 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. d'enquête 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. Également publié . ici

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Cet audio est produit dans la langue originale de l'histoire !

Trop long; Pour lire

Making security fun one episode at a time

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

Trop long; Pour lire

Ankur Tyagi

STORY’S CREDIBILITY

Guide

About Author

ÉTIQUETTES

Languages

CET ARTICLE A ÉTÉ PARU DANS...

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

Trop long; Pour lire

Ankur Tyagi

STORY’S CREDIBILITY

Guide

About Author

ÉTIQUETTES

Languages

CET ARTICLE A ÉTÉ PARU DANS...

HISTOIRES CONNEXES