<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://klee-contrib.github.io/topmodel/en/blog</id>
    <title>TopModel Blog</title>
    <updated>2026-04-24T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://klee-contrib.github.io/topmodel/en/blog"/>
    <subtitle>TopModel Blog</subtitle>
    <icon>https://klee-contrib.github.io/topmodel/en/img/IconDark.svg</icon>
    <entry>
        <title type="html"><![CDATA[Un nouveau générateur de documentation intégré]]></title>
        <id>https://klee-contrib.github.io/topmodel/en/blog/nouveau-generateur-documentation</id>
        <link href="https://klee-contrib.github.io/topmodel/en/blog/nouveau-generateur-documentation"/>
        <updated>2026-04-24T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Le module de génération documentation produit du Markdown vivant (dictionnaire de données, endpoints, Mermaid) à partir du modèle. Il s'appuie sur une capitalisation d'un module custom conçu pour un projet concret.]]></summary>
        <content type="html"><![CDATA[<p>TopModel compte désormais un <strong>générateur de documentation</strong> dédié, pensé pour produire de la <strong>documentation structurée et maintenue automatiquement</strong> à partir du modèle.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="origine">Origine<a href="https://klee-contrib.github.io/topmodel/en/blog/nouveau-generateur-documentation#origine" class="hash-link" aria-label="Direct link to Origine" title="Direct link to Origine" translate="no">​</a></h2>
<p>Ce module est une <strong>capitalisation</strong> d'un <strong>générateur custom</strong> qui avait été mis en place au sein d'un projet, ainsi que de la prévisualisation UML initialement disponible uniquement dans l'extension VSCode.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="contenu-généré">Contenu généré<a href="https://klee-contrib.github.io/topmodel/en/blog/nouveau-generateur-documentation#contenu-g%C3%A9n%C3%A9r%C3%A9" class="hash-link" aria-label="Direct link to Contenu généré" title="Direct link to Contenu généré" translate="no">​</a></h2>
<p>Trois briques, activables indépendamment, couvrent des usages basiques :</p>
<ul>
<li class=""><strong>Dictionnaire de données</strong> (tables et propriétés) ;</li>
<li class=""><strong>Liste des endpoints</strong> (métadonnées HTTP, description, rôles éventuels) ;</li>
<li class=""><strong>Diagrammes Mermaid</strong> (modèle de classes) au format prêt à l'emploi (Docusaurus, GitHub, etc.).</li>
</ul>
<p>Sortie : fichiers <strong>Markdown</strong> vers un site statique ou tout autre canal qui consomme du MD.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="pour-aller-plus-loin">Pour aller plus loin<a href="https://klee-contrib.github.io/topmodel/en/blog/nouveau-generateur-documentation#pour-aller-plus-loin" class="hash-link" aria-label="Direct link to Pour aller plus loin" title="Direct link to Pour aller plus loin" translate="no">​</a></h2>
<p>Toute la <strong>configuration</strong> (chemins, découpage par module ou par fichier, désactivation ciblée des sous-générateurs) est détaillée sur la page <a class="" href="https://klee-contrib.github.io/topmodel/en/generator/documentation">Génération &gt; Documentation</a>.</p>]]></content>
        <author>
            <name>Gildéric Deruette</name>
            <uri>https://github.com/gideruette</uri>
        </author>
        <category label="génération" term="génération"/>
        <category label="documentation" term="documentation"/>
    </entry>
</feed>