pratiques
Quiz Documenter : la documentation technique
Contrôle de connaissances de la formation Documenter : Markdown, modèle C4, documentation as code, propriétaire et revues, anti-patterns, puis générateurs de sites (Starlight, MkDocs, Hugo, Antora) et présentations.
- 321 questions en banque tirées au hasard à chaque tentative
- 32 thèmes pour un résultat détaillé par thème
- 32 guides liés à relire après une erreur
Contrôle de connaissances de la formation Documenter : Markdown, modèle C4, documentation as code, propriétaire et revues, anti-patterns, puis générateurs de sites (Starlight, MkDocs, Hugo, Antora) et présentations.
321 questions en banque 32 thèmes 32 guides liés
Comment se passe cet examen Questions tirées au sort dans toute la banque, réponses mélangées, sans limite de temps, explications à la correction.
Un examen puise dans la banque entière (321 questions, 32 thèmes) et rend un bilan par thème, là où le quiz d'une leçon ne contrôle que cette leçon. Le niveau fixe le nombre de questions ; la durée affichée est une estimation, aucun chronomètre ne coupe l'épreuve. Chaque tirage est différent : repasser le même niveau ne ramène pas les mêmes questions.
Choisissez votre niveau
Le tirage est aléatoire à chaque tentative : vous pouvez repasser le même niveau sans retomber sur les mêmes questions.
Documentation associée
Consultez ces pages pour approfondir avant ou après le quiz :
- AsciiDoc : le guide complet
- Markdown : guide complet avec cheatsheet et pièges à éviter
- Antora : créez vos sites docs statiques
- Créer un site de documentation avec Astro Starlight
- Créer une collection de postmortems SRE avec Astro Starlight
Voir les 27 autres pages
- Choisir ses outils de documentation
- Docusaurus : créer un site de documentation moderne
- Anti-patterns : les erreurs qui tuent la documentation
- Documentation as Code : pourquoi et comment
- Ownership : qui maintient la documentation ?
- Pourquoi documenter est vital ?
- Reviews et fraîcheur : garder la documentation à jour
- Hugo : créer un site de documentation DevOps
- MkDocs : créer un site de documentation DevOps
- Choisir le bon document : tutoriel, guide pratique, référence ou explication
- Documenter le code : commentaires qui disent pourquoi, docstrings, référence générée
- Écrire clair : réponse d'abord, phrases courtes, étapes vérifiables
- Écrire pour les IA : GEO, structure citable et llms.txt
- Montrer plutôt qu'écrire : captures annotées, terminal enregistré, alt
- README et CHANGELOG : l'entrée et l'historique d'un dépôt
- Créer des présentations interactives avec Reveal.js
- Paysage, dynamique, déploiement : les vues complémentaires C4
- Composants et code C4 : zoomer, et savoir s'arrêter
- Diagramme de conteneurs C4 : ce qui s'exécute et se déploie
- Diagramme de contexte C4 : votre système et son environnement
- C4 en code : Structurizr DSL, Mermaid C4 et C4-PlantUML
- Modèle C4 : clarifiez vos architectures
- D2 : conteneurs imbriqués et moteurs de mise en page
- Diagrammes as code : pourquoi et quel outil
- Mermaid : flux, séquences et états rendus par la forge
- PlantUML : séquences, composants et déploiement en Java
- Slidev : créer des présentations techniques en Markdown