Skip to content

Commit

Permalink
Sre redac (#4)
Browse files Browse the repository at this point in the history
  • Loading branch information
jupier authored Mar 5, 2024
1 parent 35a1ca3 commit fee0191
Show file tree
Hide file tree
Showing 4 changed files with 77 additions and 13 deletions.
4 changes: 2 additions & 2 deletions _posts/2024-01-13-gsxr-k8-intro.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ date: 2024-01-13
excerpt: Quelques mots pour parler du projet avec ma GSXR
---

# Quésaquo?
# Quésaquo

Je suis un grand passioné de moto. J'ai passé mon permis il y a quelques années et
ai toujours eu le souhait de m'acheter une [Suzuki GSXR](https://fr.wikipedia.org/wiki/Suzuki_GSX-R).
Expand Down Expand Up @@ -43,7 +43,7 @@ En autre;
- changer les protections de réservoir
- ...

# Pourquoi?
# Pourquoi

Simplement pour mettre la moto à mon goût et avoir l'impression qu'elle sort
du garage.
Expand Down
10 changes: 6 additions & 4 deletions _posts/2024-03-03-gsxr-k8-echappement.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@ excerpt: Première étape - échappement et garde boue arrière

# Introduction

Pour cette première étape, je vous propose de remonter:
Pour cette première étape, on monte:
- un pot d'origine trouvé sur le leboncoin à 90 euros!
- le garde boue arrière. Il s'agit du garde boue d'origine de la moto

# La vidéo
# La vidéo 📽️

Plutôt que de faire un article trop long, je vous ai fait une petite vidéo
Plutôt que de faire un article trop long, je vous propose une petite vidéo
expliquant les différentes étapes.

<iframe width="560" height="315" src="https://www.youtube.com/embed/3jPS_51i_XE?si=D2D7PnoshL2WX3fu" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe><br>
Expand All @@ -25,4 +25,6 @@ Le site propose des vues éclatées de l'ensemble de la moto.

Dans mon cas, étant donné que la moto avait été modifié par l'ancien propriétaire,
il me manquait des pièces. J'ai donc pu les racheter et savoir exactement comment
les remonter sur la moto (comme l'échappement par exemple).
les remonter sur la moto (comme l'échappement par exemple).

✌️
7 changes: 0 additions & 7 deletions _posts/2024-03-03-senior-dev-redaction.markdown

This file was deleted.

69 changes: 69 additions & 0 deletions _posts/2024-03-03-sre-redaction.markdown
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

- ...

0 comments on commit fee0191

Please sign in to comment.