Compétence · Documentation · Documenter un service ou un projet
Rédiger un document technique en AsciiDoc : structure, attributs, blocs et conversion
Écrire un document AsciiDoc avec titres, attributs, blocs avancés, admonitions, images et liens, puis le convertir avec Asciidoctor.
Commencer la leçon 1Le domaine Documentation
- 1 leçon
- ~30 min de lecture
- 1 quiz
- 0 lab de preuve
Le chemin
D'où elle vient, où elle mène
Ce qu'il faut savoir avant, où vous en êtes sur cette compétence, et ce qu'elle ouvre ensuite. Votre état se calcule dans votre navigateur, à partir de ce que vous avez lu et réussi.
Avant · aucun prérequis
Une compétence de base : vous pouvez commencer tout de suite.
Conseillé avant · 1
Cette compétence, pour vous
Rédiger un document technique en AsciiDoc : structure, attributs, blocs et conversion
Calcul en cours
Elle débloque · 1 compétence
Le chemin des bases De la base la plus en amont jusqu'à cette compétence : ce qui est en place, ce qu'il reste à lire.
Leçons
Comment l'apprendre
1 leçon, soit ~30 min, dans l'ordre du programme. Chaque leçon se termine par son quiz.
Le programme
1 leçon · ~30 min
- 1AsciiDoc : le guide complet· 30 min
Au-delà des leçons
S'évaluer, pratiquer, passer l'épreuve
Lire une leçon ne confirme rien. Une compétence se confirme par un quiz réussi, se travaille en lab guidé, et se met à l’épreuve par un challenge ou une mission ; un résultat de lab importé n’est pas vérifié par le site.
S'évaluer
1 quiz
En fin de leçon : réussi à 70 %, il confirme la compétence.
Pratiquer
Aucun lab guidé
Aucun lab guidé ne la fait encore pratiquer.
Épreuve
Aucune épreuve
Ni challenge, ni mission avec une preuve pour l'instant.
Test de positionnement
Préparation des questions…
Le détail de vos réponses
Pour chaque question posée : votre réponse, la bonne réponse, son explication et la page à relire.
Autour
Qui la demande, qui l'enseigne
Demandée par
Aucun métier publié ne la demande encore.
Enseignée par
Même bloc · Documenter un service ou un projet
- Choisir le type de document et son lecteur avant d'écrire
- Rédiger une page technique claire, accessible et vérifiable
- Doter un dépôt de son README, de son CHANGELOG et de ses ADR
- Représenter un système en diagrammes as code lisibles sans l'image
- Faire vivre une documentation : propriétaire, revue, fraîcheur
- Construire et publier une documentation contrôlée en CI
- Documenter du code : commentaires qui disent pourquoi, docstrings, référence générée
- Modéliser une architecture au-delà du contexte : composants, vues dynamiques et de déploiement, modèle unique en code
- Construire une présentation technique en Markdown ou en HTML, versionnée et exportée