La parole est aux speakers: Martin Supiot
Jusqu’au Forum PHP 2024, retrouvez nos interviews de speakers pour mieux comprendre leur parcours et le sujet qu’ils ou elles aborderont lors de leur conférence !
La conférence
Utiliser un framework pour écrire de la documentation ?Et si il suffisait d'un peu de méthode et d'organisation pour que la doc devienne agréable à utiliser mais aussi à écrire ? Au travers d'exemples culinaires simples à appréhender, nous verrons comment organiser sa documentation, comment mettre les auteurs en confiance, et comment écrire une documentation qui sera lue ! Le framework Diátaxis est encore peu connu mais il a déjà fait ses preuves chez de grands éditeurs de logiciels et j'ai eu l'occasion de le mettre en place dans une équipe technique de 60 personnes. Nous nous appuierons sur cette expérience pour montrer que la doc, ce n'est pas qu'une suite de mots et qu'on peut lui donner du sens. |
Ballroom Lamarr / G 11/10/2024 15:55-16:35 |
Si rédiger une documentation technique efficace était aussi simple que suivre une recette de cuisine, quel serait ton ingrédient secret pour convaincre les développeurs et développeuses de s’y mettre sérieusement ?
C’est un ingrédient secret et vous voudriez que je le donne comme ça ? Venez à la conf et peut être que je le dévoilerai !
Tes deux dernières conférences à l’AFUP étaient données en binôme (avec Pascal MARTIN et Elie SLOÏM). Qu’est-ce qui t’a poussé à donner ces sujets en binôme ?
Certains sujets méritent différents points de vue et de la complémentarité. Parler qualité, (Qualité front, pourquoi c’est aussi le travail du dev back !) c’est encore plus percutant avec Elie, le message passe encore mieux et ça permet d’aborder le sujet sur un angle nouveau et de toucher un public plus large.
Pour la conf avec Pascal, c’était une évidence vu le sujet (PHP, c’est vous ! Et vous pouvez contribuer !) et nos approches complémentaires. À deux on cochait quasiment toutes les cases et j’espère qu’on a fait naître des vocations !
Tu étais trésorier de l’AFUP il y a 10 ans tout juste ! As-tu une opinion sur l’évolution de l’AFUP depuis que tu as quitté le bureau ?
J’ai découvert l’AFUP à ses débuts et j’ai pu assister à mes premiers Forums PHP qui m’ont énormément apporté, aussi bien techniquement qu’humainement. J’ai apporté ma pierre à l’édifice avec un énorme plaisir, dans une équipe géniale.
Aujourd’hui je regarde le travail accompli et je vois que l’AFUP se réinvente et fait toujours plus pour PHP en France, c’est top, vivement la suite !
Une conférence présentée par
 Martin SUPIOT |
Staff Engineer chez Alma, Martin est passionné par le web et l'open-source depuis le siècle dernier. Impliqué au sein de l'AFUP et de l'antenne AFUP Nantaise ces dernières années, il ne rate pas une occasion d'échanger sur ces sujets, autour d'une bière belge de préférence ! |