Créer la doc de Nuxt avec Clément Ollivier

Durée: 17m23s

Date de sortie: 23/11/2021

Est-ce donné à tout le monde d’écrire la documentation d’un framework ? 


Dans l’épisode du jour, Clément Ollivier partage son expérience d’éditeur de contenu pour un projet Open Source.


Pour suivre Clément Ollivier : https://www.linkedin.com/in/clementollivier1/ 


Pour découvrir le cursus Artisan Développeur et apprendre à écrire du code durable :  https://ad302.fr/3syGBo 



Hébergé par Ausha. Visitez ausha.co/politique-de-confidentialite pour plus d'informations.

Bienvenue sur le podcast Artisan Developer, l'émission pour les programmeurs qui veulent vivre une carrière épanouissante.
Prêt à passer au niveau supérieur ? C'est parti !
Aujourd'hui je suis avec Clément Olivier, Clément bonjour !
Salut Benoît !
Est-ce que tu peux te présenter en quelques mots pour les auditeurs qui ne te connaîtraient pas ?
Oui bien sûr, donc moi c'est Clément, je suis développeur et je travaille à NUXTLABS en tant que head of content.
Donc NUXTLABS c'est une société d'éditeurs de logiciels open source, on est surtout connu pour le framework NUXT.js.
Alors ce que je te propose c'est que c'est quand Artisan, si tu peux nous dire deux mots sur NUXT.js, qu'est-ce que ça fait ?
Sur quoi ça s'appuie ? Mais vraiment deux mots parce que ce qui m'intéresse de comprendre vraiment c'est surtout le job que tu fais là-bas.
Mais je pense que c'est intéressant de donner un peu de background aux auditeurs qui ne connaîtraient pas NUXT.
Ouais donc NUXT c'est un framework qui est basé sur une librairie qui s'appelle VU, une librairie front-end qui s'appuie sur un principe de composants comme React.
Et NUXT en fait vient en surcouche, c'est-à-dire qui va configurer pour toi pas mal de choses puisque VU est assez agnostique sur l'architecture et les patterns que tu peux utiliser avec.
Et ensuite NUXT va aussi s'occuper d'une partie rendering côté serveur ou statique, ce qui va améliorer tes performances et ton SEO comparé à une application qui serait faite 100% en vue côté client.
Ok donc tu fais ce qu'on appelle le server-side rendering pour notamment tous les entêtes HTTP envoyer ce qui va bien ou assis au CESA ?
CESA est aussi généré en fait le HTML côté serveur ou en amont au moment du build dans le cas du statique, contrairement à VU qui par défaut propose de générer le HTML côté client dans ton navigateur.
Ok donc on est là sur un framework qui s'appuie sur un autre framework et donc on est quelque part en termes de développeur, ce que j'ai trouvé vachement intéressant dans ce framework c'est que c'est une niche dans la niche.
Déjà vu c'est plutôt le challenger, j'ai l'impression de la tribu des frameworks GES, j'ai l'impression que c'est un framework qui monte mais bon c'est pas le dominant du marché, est-ce qu'on est d'accord sur ça ou j'ai raté un truc ?
Non effectivement la librairie majeure en front aujourd'hui ça reste réact, il faut pas oublier que jQuery est quand même encore présent sur une grosse majorité de sites.
En fait c'est le numéro 1 de loin.
Mais effectivement dans cette nouvelle tribu c'est vraiment réact qui a l'ascendant mais vu à une approche un peu différente et depuis quelques années il y a vraiment une grosse traction autour de VU.
Oui j'ai l'impression que ça monte, j'ai l'impression que vous avez vu quelque chose qui est un framework qui a l'air beaucoup plus simple, beaucoup plus léger, en tout cas c'est la perception que j'en avais de loin.
Et donc vous vous positionnez au sein des développeurs vus pour proposer quelque chose de plus et du coup on peut peut-être en venir à ton job chez NUXT et si c'est ça que je trouvais vraiment intéressant c'était comprendre qu'est-ce que tu fais là bas en tant que head of content.
Parce que forcément un développeur qui fait du contenu, ça m'intéresse de comprendre ce qu'il fait quoi.
Ouais tout à fait donc moi en fait mon travail.
Je pense que pour pour bien comprendre on peut le séparer en deux parties il y a une partie un peu opérationnelle au jour le jour où il faut s'occuper de la documentation puisque NUXT c'est un framework mais il y a aussi tout un écosystème autour de modules.
Et donc il faut s'occuper de toute cette documentation là, écrire aussi des articles de blogs, des exemples, des choses complémentaires et aussi faire le lien avec la communauté à la fois pour envoyer les bonnes infos au bon moment mais aussi pour récupérer du feedback améliorer en fait tout ce travail puisque le contenu c'est quand même certain.
C'est assez important dans le dans le choix en fait quand on quand on je pense quand on choisit une librairie ou un framework une bonne documentation ça peut faire la différence.
Donc ça c'est une c'est une partie un peu au jour le jour et après il y a une partie qui est plus stratégique parce que NUXT en fait on a c'est assez versatile donc tu peux avoir aussi bien des très gros projets comme back market qui sont fait avec NUXT mais aussi beaucoup de projets de site de contenu.
Qui sont un peu moins exigeant techniquement du coup ça veut dire qu'on a aussi plusieurs publics on c'est assez facile à prendre en main donc on a des gens qui sont débutants qui sont pas encore forcément très avancés dans leur parcours dans la programmation.
Aussi bien que des gens qui doivent manager des équipes et faire des choix d'architecture sur des gros projets donc il y a une idée de aussi comment on amène des gens qui découvrent NUXT au début de leur parcours à s'améliorer à prendre en main le fond.
Pour ensuite pouvoir aussi développer leur compétence.
Et ça ça passe par quoi concrètement.
Alors ça ça passe concrètement en ce moment par par exemple une réécriture de la documentation c'est à dire vraiment essayer de.
Détablir un.
Un chemin clair.
D'apprentissage et aussi ça passe par s'appuyer sur la communauté puisqu'on a notamment des ambassadeurs que nous on appelle les ambassadeurs donc c'est les.
Les gens les plus actifs en fait de la communauté qui eux même produisent du contenu font des talks.
Avant le covi d'aller dans des conférences mais j'espère que ça va reprendre.
Et qui eux sont aussi souvent des très bons vulgarisateurs c'est-à-dire que voilà c'est des gens qui il y a un.
Tu sais il y a ce petit côté le syndrome de l'expert quand quand quelqu'un connaît trop bien un sujet c'est aussi plus dur de le vulgariser.
Donc.
Là on a des très bons vulgarisateurs qui qui vont aussi aller donner envie aux gens de s'y mettre et expliquer.
Tous les tous les concepts dans ton apposé pour s'y mettre.
Ok donc si je résume ton job en gros c'est s'occuper de la doc.
Et rendre la techno accessible facile à comprendre facile à découvrir faire le lien avec la communauté j'imagine que ça veut dire qu'il y a quelque part.
Un moyen pour toi de récupérer du feedback que ce soit je sais pas forum un échange un slack sous quelle forme tu es vraiment connecté à cette communauté.
Utilise à.
Oui donc on a un discord effectivement.
On a aussi en fait.
Le ce programme ambassadeur en fait il nous permet moi il me permet d'avoir des liens qui sont assez privilégiés avec.
Avec les ambassadeurs donc ça peut être aussi des décolle en en 1 2 1.
Voilà il y a pas mal de solution pour pour récupérer ce feedback.
Il y a des channels de support sur le discord donc après ça peut être du feedback qui m'est pas donné à moi directement mais si on voit que il y a 5 personnes qui posent une question qui ont le même problème c'est sans doute que ça devrait être dans la doc.
Parce qu'il.
Il devrait pas avoir à se poser la question.
Ce que je trouve vraiment excellent dans ce qui m'intéresse beaucoup dans son travail c'est que j'ai l'impression qu'il ressent beaucoup au mien et ce que je fais avec artisan développeur.
Alors pas dans le sens où je produis de la doc parce que je produis pas tellement doc mais je produis du contenu au sens très large avec ce podcast les vidéos les formations.
Tout le contenu que je peux produire avec cette finalement j'ai l'impression qu'on partage la même envie de partager un sujet alors moi c'est plutôt le craft et aider les développeurs à s'éclater dans leur carrière toi c'est plutôt centration next.
Mais l'impression qu'il y a cette même dynamique et si je compare dans les ans à ce que je peux voir dans les entreprises en tant que coach en tant que consultant.
Je me rends compte que c'est quelque chose qui est difficile à trouver d'avoir quelqu'un qui aime se consacrer comme ça à cette partie là faire du contenu à faire de la doc à rendre accessible pour les autres aux bénéfices des autres.
Le produit le produit sur lequel il bosse ou tout le tout le code sur lequel il travaille.
Je pense que ça demande des compétences différentes et ça demande un mindset différent.
Est-ce qu'on peut explorer ça à toi en terme de mindset.
Qu'est-ce que ça te fait de ce que ça t'a fait de passer de développeurs à ce job là.
J'imagine que tu codes plus ou en tout cas plus pareil plus avec l'intention de protier au service d'une communauté.
Comment est-ce que tu vis ces choses là.
Ouais tout à fait c'est vrai que pour moi c'était un vrai changement puisque avant j'étais développeur dans une agence donc avec des features à produire et aussi des architectures à imaginer.
Pour des appliés etc.
Donc là c'est plus du tout pareil.
Le code que je produis c'est juste pour des exemples.
En fait j'en fais beaucoup mais c'est beaucoup de snippets de test de reproduction de bug des choses comme ça mais.
La partie transmission enseignement c'est quelque chose qui moi m'a toujours plu en fait.
Et effectivement je le retrouve pas chez tout le monde.
Il y a des gens clairement que ça intéresse pas trop.
Je pense qu'il y a aussi une partie des gens que ça pourrait intéresser qui se sentent pas légitimes à le faire.
Alors qu'en réalité je pense que n'importe qui en fait si on a l'envie de le faire.
Enfin n'importe qui en tout cas je pense que beaucoup de gens pourraient pour le faire.
Mais oui oui cette cette produire du contenu et.
Transmettre transmettre des choses.
Oui c'est quelque chose qui m'a toujours intéressé.
J'ai fait pas mal de formation aussi dans des entreprises.
Je suis intervenant dans une école et c'est ça qui m'a un peu mis le pied à l'étrier pour commencer ce travail de contenu aussi.
Et c'est quoi les compétences que tu as dû développer pour vraiment embrasser ce nouveau job.
Elles sont toujours en cours d'acquisition parce que ça fait ça fait deux mois que que j'y suis.
En réalité il y a.
Il y a des compétences d'écriture ça veut dire qu'il faut quand même réussir à rester conci et en même temps précis.
En plus en langue anglaise je suppose.
En langue anglaise majoritairement.
Oui c'est ça donc donc là dessus il y a aussi un perfectionnement de l'anglais qui est nécessaire.
J'ai de la chance parce que chez NUXT un des développeurs est anglais donc c'est un peu plus.
Je le pigne souvent sur des PR pour que j'ai un œil qui m'aide à corriger les petites fautes.
Après les compétences que je suis en train d'acquérir en fait c'est plutôt des compétences marketing parce que tu vois c'est un peu comme dans le domaine du devrais.
C'est à dire que tu es à la frontière entre c'est un job que je pense que seul un développeur peut faire.
Quelqu'un qui a été développeur ou qui moi je me considère toujours développeur.
Mais en même temps il y a aussi toute une partie de ton temps qui va être plutôt consacré à réfléchir justement à une stratégie de contenu.
A faire un planning aussi de contenu pour réussir à être régulier dans tes sorties.
Je pense que c'est quelque chose que tu connais bien aussi avec avec artisan développeur.
Carrément avec artisan développeur c'est un vrai challenge et même toi depuis maintenant quelques années j'ai réussi à structurer une petite équipe qui m'aide à faire ça.
Parce que c'est pas tellement que ça prenne beaucoup de temps mais c'est une charge mentale qui pour moi est lourde en fait à prendre.
De se dire il faut penser à produire les choses et puis surtout les les publier quand il faut selon le calendrier qu'on a prévu pour que ça dure comme il faut donc c'est une récharge mentale.
Par contre dans ton cas je suis surpris j'avais quand tu dis parler de produit un de la doc moi j'imaginais une espèce de mis à jour continue de votre documentation.
Clairement je suis persuadé que c'est un enjeu majeur dans l'adoption d'une technologie.
Par contre quand tu parles de calendrier éditorial et de publication qu'est ce que tu publie en dehors de cette doc.
En fait en dehors de la doc il y a des postes de blog par exemple tu vois il y a une nouvelle release du framework.
Tu vas faire une espèce de version intelligible digeste du rythmique.
Exactement c'est ça c'est que pour moi la doc c'est une bonne doc c'est indispensable mais c'est pas suffisant.
Dans une bonne doc ça va permettre de convaincre mais ça va pas forcément donner envie de s'intéresser au sujet quoi.
C'est ça et c'est aussi facile tu vois de louper des features c'est à dire que lire un change log déjà il faut être honnête il y a peu de gens qui lisent.
Les change log détaillés à chaque fois et en plus de ça c'est facile en fait de passer à côté d'une nouvelle feature qui pourrait t'intéresser.
Dans une ligne dans une ligne sur 40 de ligne tu ne vas pas forcément la voir alors que tu vas peut-être pouvoir mettre un peu plus de spotlight dessus dans ton article.
Exactement c'est ça et puis c'est aussi le moyen de donner des use cases qui soient un peu plus.
Un peu plus proche aussi de ce que de ce que nos utilisateurs font sur le terrain que une doc qui peut être un peu un peu froide parce qu'il faut qu'elle soit exhaustive il faut que.
Voilà c'est pas les mêmes tout à fait les mêmes enjeux.
C'est excellent donc il y a vraiment cette idée de donner envie de s'intéresser au vrai mort je repense à ça souvent.
Encore une fois je reviens sur les entreprises.
Je vois parfois des boîtes j'en ai eu une en tête notamment ou il galère un peu sur ces sujets là.
Ils sont une croix centaine de développeurs et je me dis si il y avait une ou deux personnes qui faisaient ce taf là.
Alors oui ce serait pas forcément super sympa pour cette personne se manger toute cette doc mais ça aiderait tellement les 80 18 autres à être plus efficace.
Et je me dis je pense que c'est rentable quoi tu as quelqu'un qui aide tout le monde à être 10% plus efficace.
C'est sûr c'est rentable sur ces échelles donc là où je trouve quelque chose de beau dans le métier que tu fais c'est que.
Tu es des milliers de développeurs à être plus efficace dans leur taf à s'approprier une ex à avancer et ça je trouve ça super excitant personnellement.
Ah bah ouais moi aussi c'est c'est ce qui me motive et tu sais on parle souvent de développeur expérience mais pour moi elle passe aussi par.
Par par tous ces aspects là en dehors du dehors du code c'est vraiment des moi c'est des choses qui me qui me motive beaucoup et je pense que.
Le peut-être peut-être des développeurs en fait s'imagine pas qu'il pourrait aussi faire ce genre de ce genre de métier ça demande pas d'être expert.
Ça demande d'avoir de l'empathie pour les utilisateurs de.
Ça demande des compétences de rédactionnel mais qui s'apprennent comme on peut apprendre un nouveau langage etc.
Je pense que c'est quelque chose qui gagne à être connu aussi.
Et bah écoute Clément je trouve que ce que soit le mot de la fin merci pour merci pour ton partage d'expérience si les auditeurs veulent en savoir plus sur ce que tu fais ils peuvent venir t'écouter de lire de voir ou.
Alors ils peuvent me retrouver sur Twitter c'est.
Clément Codes.
C O D S.
Et je vais bientôt lancer mon blog perso pour approfondir justement toutes ces.
Toutes cette idée de d'écriture et de de partage au-delà de au-delà de Next.
Génial.
Mais j'aurais à coeur de.
J'aurais à coeur de lire au moins les premiers articles pour voir un peu ce que tu racontes avec plaisir.
Bah écoute merci Clément c'est top.
Quartatoche à auditeurs j'espère que tu as aimé cet épisode également.
Je pense que c'est typiquement un épisode qui serait intéressant de partager avec tes collègues en particulier si tu es dans cette situation où tu te retrouves dans une équipe interne ou tu as une techno ou tu as des librairies internes des choses.
A faire comprendre à aider les autres tes collègues développeurs à adopter.
Je pense que c'est un épisode qui peut vraiment être sympa en écoute partage.
Le principe est simple tu réunis tes potes autour de tes collègues en espérant que tu sois pas avec eux autour d'un café tu leur fais écouter et vous en débattez ça te prend 20 minutes.
Allez 25 minutes avec les quelques échanges d'idées et comme ça ça donnera peut-être des idées à certains peut-être qu'un d'un qui auront envie de s'y mettre et des contribuesses que tout le monde aille plus vite dans le dans le corps quotidien.
Je te remercie et je te dis à bientôt.

Les infos glanées

Je suis une fonctionnalité encore en dévelopement

Signaler une erreur

ArtisanDéveloppeur

Artisan Développeur est un podcast destiné aux développeurs qui veulent bâtir une carrière épanouissante. Hébergé par Ausha. Visitez ausha.co/fr/politique-de-confidentialite pour plus d'informations.
Tags
Card title

Lien du podcast

[{'term': 'Technology', 'label': None, 'scheme': None}, {'term': 'Technology', 'label': None, 'scheme': 'http://www.itunes.com/'}]

Go somewhere