Clean code et refactoring - 04 - Commentaires et documentation : quand le code ne suffit pas
Les bons commentaires expliquent le pourquoi, pas le quoi. JSDoc, TODO, types comme documentation : guide pratique pour commenter juste.
Articles : documentation
4 articles sur le thème "documentation".
Clean code et refactoring - 20 - Conventions d'équipe et ADR
Les conventions d'équipe reduisent la charge mentale et accelerent l'onboarding. Les ADR documentent les décisions qui comptent.
REST API design - 18 - OpenAPI : le contrat entre ton API et le monde
OpenAPI 3.x, YAML, code-first vs spec-first, openapi-typescript, $ref et examples pour une spec qui sert vraiment.
REST API design - 19 - Documentation : une API non documentee est une API inutile
Swagger UI, Redoc, Scalar, code examples, authentification dans la doc et synchronisation spec/code.