Format: 40 minutes
Cette conférence est principalement axée autour des solutions de la communauté PHP. Pour autant la présentation de ce pattern et son intérêt pour structurer le code d’un projet sont vrais pour tout les langages !
Aujourd’hui les APIs sont partout, les documenter correctement est un prérequis pour qu’elles soient utilisées. Cependant un problème persiste quand on a affaire à de la doc : comment garantir qu’elle est à jour ou que le code l’implémente correctement ?
Sur un projet où nous utilisons OpenAPI, malgré la volonté d’avoir une documentation à jour et propre, les utilisateurs et utilisatrices rencontraient des problèmes. J’ai commencé à chercher un moyen de valider cette documentation pour capturer les erreurs avant les utilisateurs et utilisatrices. OpenAPI est devenu le moyen le plus puissant de décrire une API HTTP aujourd’hui. L’écosystème est très riche avec de nombreux générateurs (code et documentation). L’avantage de ce format est qu’il est très technique.
Dans ce talk, je vais vous présenter mes recherches et comment nous avons finalement mise en place des tests automatiques basés sur la documentation. Combiné à un système d’intégration continue, il détecte les erreurs et nous laisse les résoudre avant de passer en production. La documentation permet de vérifier que l’API fonctionne et l’API permet de vérifier que la documentation est à jour.
Aujourd’hui toute l’équipe est plus confiante sur notre code et notre documentation. Toutes ces validations ont également aidé les devs qui n’étaient pas à l’aise avec l’écriture de la documentation à prendre confiance et être sereins lors de modifications…
Abstract de présentation
Retrouvez les slides sur : public.chstudio.fr
Cette présentation a été donnée durant plusieurs évènements :
