PHPTour 2018
[:fr]La parole est aux speakers : Sarah Haïm-Lubczanski[:]
[:fr]Jusqu’au PHP Tour Montpellier 2018, retrouvez nos interviews de speakers pour mieux comprendre leur parcours et le sujet qu’ils aborderont lors de leur conférence !
La conférence
Sans documentation, la fonctionnalité n'existe pas !La nouvelle fonctionnalité est prête, tout le monde est ravi. Les utilisateurices vont-ils savoir s’en servir ? Si vous pensez que le changelog et la PHPDoc suffisent, je voudrais vous demander : pourquoi priver vos utilisateurices des meilleures parties de votre logiciel ? Je vous propose de définir la qualité minimale attendue pour une documentation et d’examiner l’effort à fournir pour l’atteindre. Nous parlerons des process de documentation et de comment on fait pour documenter avec les moyens et les compétences disponibles. |
Salle Morpheus 17/05/2018 15:15-15:55 |
Tu es Technical Writer, ce qui un poste peu fréquent. Peux-tu nous en parler ?
En résumé : je suis en charge de la documentation technique du logiciel, open source, que produit mon entreprise.
Dans la communauté de la documentation (hé oui, elle existe), un terme a été trouvé qui paraît plus juste pour mon métier, il s’agit de Documentarian. Ce nouveau terme reflète mieux le fait que l’écriture de documentation est la moins fréquente de mes tâches. La majorité de mon travail est de l’architecture d’information, et de la communication avec le reste des personnes qui permettent au logiciel d’exister (les développeurs, les responsables de produits, les consultants, etc.).
Chez eZ Systems, je fais partie du département Ingénierie et je travaille avec des développeurs PHP et frontend. Ayant moi-même un passé de développeuse PHP, je me sens à même de comprendre leurs contraintes et leur boulot.
Je ne travaille pas seule, nous sommes 3 dans la Team Doc et nous collaborons au jour le jour avec la quinzaine de développeurs de la Team Dev.
Les points communs avec les développeurs PHP est que je résous des problèmes pour les utilisateurs. Je travaille au rythme des releases de notre logiciel. Les sprints rythment mes périodes de travail, et je participe à la démo et à la retrospective.