Découvrez le métier de Technical Writer et Developer Advocate : documentation technique, DevRel, création de contenu tech et community advocacy.
Technical Writer : créateur de documentation
Un Technical Writer (rédacteur technique) est un professionnel spécialisé dans la création de documentation claire et accessible pour les développeurs et utilisateurs techniques. C'est un rôle crucial dans les entreprises tech, souvent sous-estimé mais absolument stratégique.
Contrairement à l'idée reçue, ce n'est pas un rôle marginal : une bonne documentation peut faire la différence entre une API adoptée par 10 entreprises et une API utilisée par 10 000.
Developer Advocacy et DevRel
Le Technical Writer moderne ne crée pas juste de la documentation : il est aussi un Developer Advocate (DevRel). Cela signifie :
- Créer du contenu éducatif (tutoriels, guides, articles de blog)
- Présenter la technologie lors de conférences et webinaires
- Interagir avec la communauté (forums, réseaux sociaux, GitHub)
- Recueillir le feedback des devs pour améliorer le produit
- Être l'ambassadeur de la technologie
DevRel est plus large que Technical Writing. C'est le lien entre le produit et les devs.
Missions quotidiennes
Matin : Rédiger de la documentation API avec exemples de code
Midi : Rédiger un tutoriel sur "Comment intégrer notre SDK en 5 minutes"
Après-midi : Mettre à jour les guides suite à une nouvelle version du produit
Soirée : Répondre aux questions des devs sur Stack Overflow et GitHub
Autres responsabilités :
- Créer des exemples de code complets et testables
- Préparer des démonstrations vidéo
- Animer un blog technique
- Collaborer avec les Product Managers et Engineers
- Mesurer l'impact de la documentation (analytics)
Compétences requises
Compétences techniques
- Maîtrise du code — JavaScript, Python, ou autre langage courant (pour comprendre et écrire des exemples)
- Git et GitHub — créer des repos d'exemples
- API REST & GraphQL — documenter les endpoints avec Swagger/OpenAPI
- Markdown et HTML — pour écrire la documentation
- SEO basique — faire découvrir la documentation
Compétences en rédaction
- Clarté et concision — expliquer simplement des concepts complexes
- Écoute des utilisateurs — comprendre les douleurs et besoins
- Storytelling — raconter pourquoi un concept est important
- Rigueur — les erreurs dans les docs sont graves
Outils et technologies
| Domaine | Outils populaires |
|---|---|
| Documentation | MkDocs, Docusaurus, GitBook, Notion |
| API Docs | Swagger/OpenAPI, Postman, Stoplight |
| Blogging | Dev.to, Medium, Hugo, Gatsby |
| Vidéo | OBS, Loom, Adobe Premiere |
| Gestion | Jira, GitHub Issues, Trello |
| Analytics | Google Analytics, Mixpanel, Segment |
Types de contenu produit
- Documentation API — spécification complète de tous les endpoints avec exemples
- Getting Started Guides — "Démarrer en 5 minutes"
- Tutoriels vidéo — montrer visuellement comment utiliser le produit
- Blog technique — articles de fond sur la meilleure pratique
- Code samples et repos — exemples complets et testables
- FAQs et troubleshooting — résoudre les problèmes les plus courants
- Talks et conférences — présenter devant des audiences tech
Salaires et carrière
Salaires en France (2026) :
- Junior TW (0-2 ans) — 30 000 à 38 000 €/an
- Confirmé (2-5 ans) — 38 000 à 50 000 €/an
- Senior / DevRel lead (5+ ans) — 50 000 à 75 000 €/an
Évolution de carrière
- TW → Developer Advocate — rôle plus communicant et extérieur
- TW → Content Lead — gérer une équipe de writers
- TW → Product Manager — utiliser votre compreh du dev pour diriger le produit
- TW → Consultant/Coach — aider d'autres orgs à créer de bonnes docs
De développeur à Technical Writer
Beaucoup de TW viennent du développement. Voici le chemin :
Étape 1 : Démontrez votre passion pour la documentation
Écrivez des tutoriels sur votre blog ou Dev.to. Créez des README excellents pour vos projets GitHub. Devenez le "dev qui explique bien" dans votre équipe.
Étape 2 : Apprenez la rédaction technique
Lisez "Docs for Developers" par Jared Bhatti. Suivez des cours en Technical Writing. Étudiez des excellentes documentations (AWS, Google Cloud, Stripe).
Étape 3 : Construisez un portfolio
Créez un portfolio montrant :
- 5-10 articles ou tutoriels que vous avez écrits
- Des exemples de code que vous avez documentés
- Un projet open source avec excellente documentation
Étape 4 : Cherchez une opportunité interne ou en startup
Demandez à votre équipe si vous pouvez documenter un projet. Les startups embauchent souvent des TW avec background dev.
Conclusion
Le rôle de Technical Writer est une excellente carrière pour les développeurs qui aiment expliquer, communiquer et influencer. La demande est forte, les salaires sont compétitifs, et l'impact est réel : une documentation bien faite peut changer la trajectoire d'un produit.
Si vous aimez le code mais aussi expliquer comment ça marche, TW est une transition naturelle. Votre background dev est un atout majeur qu'aucun writer classique n'a.
Questions fréquentes
