Markdown Editor

Kit documentation technique

Planifier et rédiger la documentation produit : plan de documentation, guide de style, tutoriels, guides pratiques et références Diataxis, guides utilisateur.

Étape 1

Planification

  1. Documentation Plan Template

    Standard

    Docs plan – audiences and tasks, deliverables inventory, IA, style, pipeline, review, localisation, accessibility, metrics

  2. Technical Writing Style Guide Template

    Standard

    Tech writing style guide – voice, grammar do/don't, terminology, UI and code conventions, procedures, inclusive language

Étape 2

Apprentissage

  1. Quickstart Guide Template

    Standard

    Quickstart – zero to first success, verifiable steps

    Diataxis (tutorial)
  2. Tutorial Template (Diataxis)

    Standard

    Diátaxis tutorial – learning goals, prerequisites, numbered lessons with visible results, checkpoints, troubleshooting

    Diátaxis
  3. How-To Guide Template (Diataxis)

    Standard

    How-to guide (Diataxis) – goal-first recipe

    Diataxis (how-to)
  4. Explanation Document Template (Diataxis)

    Standard

    Explanation (Diataxis) – why, trade-offs, limits

    Diataxis (explanation)
Étape 3

Conceptions de référence

  1. Reference Documentation Template (Diataxis)

    Standard

    Diátaxis reference page – neutral, consistently structured entries for functions, types, errors and constants

    Diátaxis
  2. API Overview and Getting Started Template

    Standard

    API landing page – what it does, base URLs, auth in 3 steps, first request, key resources, errors, limits, next steps

  3. CLI Reference Template (Man Page Sections)

    Standard

    Command-line reference in man-page order – synopsis, options, commands, environment, files, exit status, examples

  4. Configuration Reference Template

    Standard

    Settings reference – precedence rules, file format, per-key type/default/range/env var/since, deprecations, validation

Étape 4

Guides pratiques

  1. User Manual Template (ISO/IEC/IEEE 26514)

    Complet

    Full user manual per ISO/IEC/IEEE 26514 – conventions, notices, concepts, task procedures, reference, errors, accessibility

    ISO/IEC/IEEE 26514:2022
  2. Installation and Configuration Guide Template (ISO/IEC/IEEE 26514)

    Complet

    Install guide – requirements, checklist, per-platform steps, verification, config parameters, upgrade, uninstall, hardening

    ISO/IEC/IEEE 26514:2022
  3. Administrator Guide Template (ISO/IEC/IEEE 26514)

    Complet

    Admin guide – roles, architecture, access, backup/restore, monitoring, maintenance, scaling, security ops, DR, audit

    ISO/IEC/IEEE 26514:2022
  4. Developer and SDK Guide Template

    Complet

    Developer guide – setup, auth, multi-language quick start, errors, pagination, rate limits, webhooks, sandbox, versioning

  5. Migration Guide Template

    Standard

    Upgrade/migration guide – who is affected, breaking changes table, timeline, checklist, steps, before/after code, rollback

  6. Troubleshooting Guide Template

    Standard

    Symptom/cause/fix index + known issues

Étape 5

Fichiers du projet

  1. README Template

    Standard

    Lean project README – badges, config table, mermaid

  2. Changelog Template (Keep a Changelog)

    Standard

    Keep a Changelog + SemVer

    Keep a Changelog
  3. Release Notes Template

    Standard

    Release notes: highlights, features, fixes, breaking changes with migration, deprecations, CVE fixes, upgrade steps