La documentation

Cette rubrique est une annexe du cours-devops - Les principes de DevOps où l'approche Docs as code est présentée. Elle la complète pour faire le lien avec l'IA (voir Markdown) et pour guider dans la mise en oeuvre (voir Docs as code).

• Markdown

  Rédiger la documentation en Markdown : intérêt (y compris pour l'IA), syntaxe de base et étendue, tableaux.

• Docs as code

  Traiter la documentation comme du code : principes, intérêt, limites et mise en oeuvre pas à pas.

• Schémas

  Dessiner des schémas éditables ou les générer à partir de code (schemas as code).

• Générateurs de site

  Générer un site web à partir de fichiers Markdown avec un générateur de site statique.

• Diaporamas

  Produire des diaporamas en HTML à partir de Markdown.

• Enregistrement du terminal

  Enregistrer une session de terminal et la rejouer dans une page web.