- Tous les développeurs savent bien écrire du code, mais pour devenir de meilleurs ingénieurs, ils doivent améliorer leurs compétences en écriture
Pourquoi faut-il écrire ?
- L’écriture est un moyen d’organiser sa pensée
- L’écriture est un moyen d’apprendre quelque chose
- L’écriture aide à repérer les erreurs
Comment écrire davantage ?
- À retenir : la lecture est une habitude, l’écriture est une compétence
- Pour maîtriser une compétence, il faut écrire davantage
- L’une des façons les plus simples d’écrire plus est d’aborder les design reviews différemment
- Au lieu de les détester et de les traiter comme un devoir, essayez de les faire avec enthousiasme
- Chaque fois que vous rédigez une design review, cherchez à améliorer quelque chose
- Essayez d’écrire plus court sans perdre l’essentiel, puis plus long pour couvrir davantage de cas d’usage
- Si vous voulez améliorer votre écriture en dehors du travail, essayez de lancer un blog
- Si un blog vous semble trop engageant, essayez de répondre à des questions sur Stack Overflow. Ne copiez pas le code : concentrez-vous sur le contenu textuel
- Dernier conseil : ne faites pas de Copy & Paste.
- Le problème, c’est que tout le monde se contente de copier des commandes depuis GitHub/Google
- Si vous craignez de devenir moins productif, rappelez-vous que l’évaluation ne repose pas sur la quantité de code que vous écrivez ni sur la vitesse à laquelle vous terminez vos tâches
- On ne peut pas éviter l’écriture. Qu’on aime ça ou non, pour devenir un ingénieur 10x, il faut écrire
- "Rédigez de la documentation, rédigez des design reviews, créez des présentations. Plus vous serez à l’aise à l’écrit, plus vite vous deviendrez un meilleur ingénieur."
1 commentaires
Google Technical Writing pour les ingénieurs [en anglais]
Les 4 grands principes de la rédaction technique
Les 10 commandements de la rédaction technique pour les développeurs
Les principes pour finaliser proprement une rédaction technique