ReDoc
Documentation API de référence générée depuis OpenAPI

ReDoc (Redoc) est un outil open source édité par Redocly qui génère automatiquement une documentation de référence d’API soignée et prête pour la production à partir d’une spécification OpenAPI. Il transforme un simple fichier de description (OpenAPI, et plus largement les standards pris en charge par la plateforme Redocly) en un site de documentation lisible, structuré en trois colonnes, sans nécessiter d’écrire la mise en page à la main. C’est l’un des générateurs de documentation API les plus populaires, avec plus d’un million de téléchargements hebdomadaires.
Le fonctionnement repose sur une approche docs-as-code intégrée aux dépôts Git. ReDoc lit la spécification OpenAPI et produit une page interactive avec exemples de code, navigation par liens profonds, recherche et rendu responsive. Au sein de la suite Redocly, il s’accompagne d’outils complémentaires comme Reunite (édition et revue collaborative), Revel (portail développeur), Reef (catalogue interne) et de serveurs mock, de linting et de validation. La version open source s’utilise en autonomie tandis que les fonctions avancées passent par les offres payantes.
Il s’adresse aux développeurs, rédacteurs techniques, product managers et équipes qui publient des API. Ses forces sont la qualité de rendu immédiate, la nature open source du cœur et l’écosystème Redocly autour. En limites, les usages avancés (hébergement, domaine personnalisé, SSO, analytics) sont réservés aux offres payantes, et l’outil reste centré sur la documentation d’API plutôt que sur un usage généraliste.
Notes détaillées 3.8/5
Fonctionnalités clés
- Génération de documentation depuis OpenAPI
- Rendu interactif à trois colonnes
- Exemples de code intégrés
- Liens profonds et navigation
- Serveurs mock et linting (suite Redocly)
- Workflow docs-as-code via Git
👍 Avantages
- Cœur open source et largement adopté
- Documentation soignée prête pour la production
- Intégration docs-as-code avec Git
- Écosystème Redocly complémentaire
👎 Inconvénients
- Fonctions avancées payantes (SSO, analytics, hébergement)
- Centré uniquement sur la documentation d'API
- Configuration technique nécessaire
