-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
77 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
--- | ||
title: "L'importance de l'écriture pour un Software Engineer" | ||
date: 2024-03-03 | ||
excerpt: Plus tu vieillis, moins tu codes | ||
--- | ||
|
||
🚧 ARTICLE EN CHANTIER 🚧 | ||
|
||
# Mise en bouche 🫦 | ||
|
||
Voilà bientôt 10 ans que je travail en tant qu'ingénieur informatique. | ||
Mon poste à beaucoup évolué au fur et à mesure des années et des entreprises | ||
pour lesquelles j'ai travaillé. | ||
|
||
Je suis actuellement ce qu'on appel un "Software Engineer Senior" (Je n'ai jamais | ||
été très fan de cette dénomination). | ||
|
||
Dans les premières années, j'ai fait beaucoup de développement (je pissais du code | ||
quoi), mais plus les années avances, plus la quantité de code que je produis | ||
diminue, plus la quantité de document que je rédige augmente. | ||
|
||
J'aimerais parler de ce phénomène. | ||
|
||
# C'est quoi un Software Engineer? | ||
|
||
TODO | ||
|
||
# Tu pisses de la doc'⁉️ | ||
|
||
Je ne dirais pas que je pisse de la doc'. Il est certains que la quantité de document | ||
que je produis quotidiennement est bien plus importante qu'il y a 5 ans. | ||
|
||
Mais pourquoi? | ||
|
||
Simplement parce que je pense qu'on attend cela de moi. D'après les moeurs, un Software Engineer | ||
'Senior' doit être capable de rédiger des documents clair et efficace afin de, par exemple, | ||
proposer une solution à un problème. | ||
|
||
Aussi parce que je pense que ça en vaut la peine. Prenons le cas de n'importe quelle librairie en vogue. | ||
Pensez vous que cet lib' serait aussi répendue si elle n'avait pas une documentation à la hauteur | ||
qui en décrit ses fonctionnalités? A mon sens, une documentation bien rédigée est tout aussi | ||
difficile à écrire que le code quelle renferme. | ||
|
||
Avec le temps, on apprécie apprendre à écrire. Ca peut paraître bête, mais c'est une réalité. | ||
La rédaction ca s'apprend. Au début, on cherche ses mots, les tournures des phrases ne sont pas | ||
bonnes, on ne se relit pas. Avec le temps, on s'améliore, on se relit, on peaufine son | ||
discours...etc. Et quand le texte nous convient, on est fier de soi. Le message est clair, précis. | ||
Un peu comme quand on code ☺️ | ||
|
||
# Imposteur❗ | ||
|
||
TODO | ||
|
||
# Quelques conseils💡 | ||
|
||
Cette liste de conseils à pour but d'évoluer avec le temps, mes expériences et vos commentaires. N'hésitez | ||
pas à donner vos propres techniques dans les commentaires de ce post. | ||
|
||
- Dump tes idées, les grandes lignes que tu as en tête; au début, ne te prends pas la tête avec les fioritures, | ||
écris tout ce qui te passe par la tête, même si après coup ce sera supprimé. Je trouve que c'est important | ||
pour se donner confiance en soi et se lancer dans la rédaction. Ca fait peur de se retrouver devant une page | ||
blanche. Autant la noircir un peu pour se donner un peu de courage, même si c'est pas très bien écrit. | ||
|
||
- Rédiges ton document étape par étape; il est difficile de rédiger quelque chose parfaitement du premier | ||
coup. Fais un premier jet, sauvegarde le et retournes y le lendemain. Ca te permet d'y réfléchir de manière | ||
asynchrone et de faire murir d'autres idées dans ton esprit | ||
|
||
- ... | ||
|