id: information-typing-concepts
type: concept
title: Le typage de l’information en documentation technique
shortdesc: Comprendre les principes fondamentaux de la rédaction structurée modulaire et la séparation entre tâches, concepts et références.

intro: >
  Le typage de l’information consiste à organiser les contenus techniques selon leur intention de communication plutôt que par chapitre linéaire ou support de diffusion.
  Issu de la méthode Information Mapping de Robert Horn et formalisé dans la norme OASIS DITA, ce principe répond aux besoins cognitifs distincts des lecteurs en situation de travail.

sections:
  - title: Les trois archétypes documentaires fondamentaux
    content: >
      Au lieu de mélanger des descriptions théoriques, des modes d’emploi et des listes de paramètres dans un texte monolithique, la rédaction structurée isole chaque finalité :
    list:
      type: unordered
      items:
        - "**Tâches (procédurales)** : Répondent à la question *Comment faire ?* par des instructions séquentielles concrètes menant à un résultat vérifiable."
        - "**Concepts (explicatifs)** : Répondent aux questions *Qu’est-ce que c’est ?* et *Pourquoi cela fonctionne-t-il ainsi ?* pour bâtir un modèle mental clair."
        - "**Références (factuelles)** : Répondent à la question *Quels sont les paramètres ?* en proposant des données structurées et tabulées propices à la recherche rapide."

  - title: Bénéfices d’une typologie sémantique stricte
    content: >
      L’application de contrats structurels rigoureux améliore directement la qualité documentaire :
    subsections:
      - title: Efficacité de lecture et charge cognitive
        content: >
          L’utilisateur qui effectue une maintenance mécanique a besoin d’instructions directes sans digression théorique. Inversement, l’architecte système a besoin d’explications conceptuelles claires sans liste de boutons à cliquer.
      - title: Réutilisation et modularité du contenu
        content: >
          Chaque sujet forme une unité autonome pouvant être assemblée dans différents livrables (sites web, manuels PDF, aide contextuelle) sans dupliquer les sources.
      - title: Validation automatisée et régularité
        content: >
          Des schémas de validation garantissent que chaque tâche contient des étapes exploitables, chaque concept aborde les principes de fond et chaque page de référence fournit des caractéristiques tabulées.

  - title: Mettre en œuvre DITA en YAML sans XML
    content: >
      Le standard DITA d’origine repose sur des grammaires XML (DTD, XSD) et la chaîne DITA-OT, souvent jugées lourdes par les équipes de développement.
      En transposant la sémantique DITA (`cmd`, `info`, `substeps`, `stepresult`, `prereq`, `context`) dans des fichiers YAML lisibles :
    list:
      type: unordered
      items:
        - "Les rédacteurs travaillent sur des fichiers simples dont les révisions se visualisent parfaitement dans Git."
        - "Les générateurs de sites modernes tels qu’Astro produisent un code HTML sémantique et accessible sans pipeline XSLT."
        - "Des validateurs de schémas (comme Zod) contrôlent la structure et l’intégrité référentielle dès la compilation."

example: >
  Dans notre exemple d’entretien de tondeuse, la tâche `replace-lawnmower-blade` fournit la marche à suivre mécanique,
  la référence `lawnmower-blade-reference` regroupe les couples de serrage et tolérances d’usure, et ce concept explicite la logique d’organisation.

notes:
  - type: tip
    content: >
      Pour valider le type d’un sujet, posez-vous la question : si votre document contient à la fois des étapes et un grand tableau de caractéristiques, isolez le tableau dans un sujet Référence et reliez-les par des liens associés.

related:
  - id: replace-lawnmower-blade
    relationship: task
    title: Remplacer une lame de tondeuse à gazon
  - id: lawnmower-blade-reference
    relationship: reference
    title: Caractéristiques et paramètres d’entretien de la lame de tondeuse