Estéban SOUBIRAN

Les origines d'un tutoriel

Depuis que je me forme au développement web en lisant ou en regardant des vidéos sur internet, j'ai toujours eu une certaine admiration pour les personnes qui créent du contenu pour faire apprendre les autres, pour les personnes qui sont capables de transmettre aux autres leur savoir-faire et leur passion. Aussi, je trouve que réussir à réaliser un tutoriel, à expliquer à une autre personne quelque chose est la preuve que l'on a compris le sujet, qu'on le maîtrise.

En 2020, j'ai commencé à écrire un ensemble de cours pour apprendre à utiliser l'HTML, le CSS et le JS. Cependant, je n'ai pas réussi à terminer et j'ai réellement pris conscience de la difficultés d'écrire un tutoriel, du temps nécessaire et de la maîtrise qu'il faut avoir.

Depuis, j'ai conservé l'idée jusqu'à ce que je trouve une occasion de réessayer l'exercice.

La création d'un tutoriel

Fin août 2021, en travaillant sur un projet de développement web pour la vie associative de mon école, j'ai découvert Adonisjs. Un framework web qui permet de développer des applications web avec une architecture monolithe ou de créer des API REST. Dans le même temps, un ami m'a indiqué vouloir aborder le développement backend. Je me suis alors dis que c'était l'occasion de retenter d'écrire un tutoriel !

Tout d'abord, je me suis posé la question du sujet à aborder. Étant donné que mon ami allait faire ses premiers pas dans cet univers, j'ai décidé d'explorer le plus largement possible, en couvrant le plus de concepts. C'est comme cela que m'est venu l'idée de réaliser un blog.

Avec ce blog, le lecteur touche à presque toutes les fonctionnalités d'Adonisjs et l'explore le plus largement possible en mettant en lien beaucoup de ces concepts et en indiquant où trouver la ressource correspondante dans la documentation. À la fin du tutoriel, le lecteur est autonome !

Vous pouvez retrouver la série ici ! J'espère qu'elle vous plaira si vous la faites et n'hésitez pas à la commenter ou à la partager !

Une bonne expérience ?

Écrire un tutoriel et le publier autour de moi, ça a été une première pour moi. Mais cette exercice permet de réellement savoir si on maîtrise notre sujet. Aussi, il oblige à être très rigoureux dans tout ce qui est dit pour ne pas perdre le lecteur. Ainsi, il est obligatoire de se mettre dans la peau du débutant pour s'assurer que le tutoriel est clair et concis. C'est aussi un travail qui demande du temps.

Mais cette écrire m'a permis de réellement m'obliger à comprendre et rédiger quelques articles, ça ne fait jamais de mal !

Aussi, j'ai pu avoir quelques retours et ces personnes étaient très contente ! Une bonne expérience validée que je vais certainement renouveler !

À savoir

J'ai eu l'occasion de tester différentes librairies comme Express ou Fastify ou différents frameworks comme Nestjs ou Feathersjs. Mais j'ai vraiment eu un coup de coeur pour Adonisjs. Je vous conseil d'ailleurs d'y jeter un oeil et de lui faire confiance, il ne vous décevra pas, la documentation non plus !