---
title: Choisir le bon type de contenu
description: Structurez les tutoriels, les guides pratiques, les concepts, les références et les notes de version pour que les lecteurs trouvent le type de réponse dont ils ont besoin.
url: https://docs.thally.io/fr/guides/content-types
---

# Choisir le bon type de contenu

Structurez les tutoriels, les guides pratiques, les concepts, les références et les notes de version pour que les lecteurs trouvent le type de réponse dont ils ont besoin.

{/* thally:ai-translation locale=fr source-sha=0d3e6b7db63c6ca0e1a7377e2ddf5daf3abd83a695d2e0c6054a70b445d767ae */}
{/* Remove the marker above before manual edits to opt out of automatic refresh. */}

Commencez chaque page avec un objectif de lecteur. Séparer le contenu d'apprentissage, de tâche, d'explication et de recherche rend un ensemble de documentation plus facile à parcourir et à maintenir.

## Tutoriel

Utilisez un tutoriel pour aider un nouveau lecteur à obtenir un premier résultat complet. Fournissez les prérequis, une séquence guidée, une étape de vérification claire et des tâches suivantes ciblées.

Le [Démarrage rapide](/quickstart) est un tutoriel : il crée un site, ajoute une page et vérifie le résultat en un seul chemin.

## Guide pratique

Utilisez un guide pratique pour une tâche spécifique que le lecteur comprend déjà, comme le déploiement sur Cloudflare ou la protection d'un site avec un mot de passe.

Une page de tâche utile suit généralement cet ordre :

1. Énoncez le résultat.
2. Énumérez les prérequis.
3. Donnez la procédure la plus courte et fiable.
4. Montrez comment le vérifier.
5. Couvrez les défaillances probables près de la tâche.
6. Liez les tâches connexes suivantes.

Nommez les pages de tâche avec des verbes : **Déployer sur Vercel**, **Ajouter des extraits réutilisables**, ou **Configurer le terrain de jeu API**.

## Concept

Utilisez une page de concept pour expliquer le comportement d'un système ou pourquoi une décision est importante. Les pages de concept doivent clarifier un modèle mental, non cacher une longue procédure de configuration.

Les exemples incluent [Comment Thally fonctionne](/architecture) et le [pipeline de changement de produit](/product-change-pipeline).

## Référence

Utilisez une page de référence pour les faits complets et analysables : champs de configuration, commandes, composants, variables d'environnement ou points de terminaison API. Préférez les tableaux, les signatures, les valeurs par défaut et les contraintes à la narration.

Les pages de référence ne doivent pas être le seul endroit où un débutant peut découvrir une tâche. Liez-les à partir du guide pertinent, puis reliez-les à un exemple pratique.

## Entrée du journal des modifications

Utilisez le journal des modifications pour un changement de produit daté. Expliquez ce qui a changé, qui cela affecte et ce que le lecteur doit faire. Ne l'utilisez pas comme substitut à la mise à jour de la page de guide permanent ou de référence.

## Liste de contrôle de la page

- Le titre correspond-il à une intention de lecteur ?
- Le résultat attendu est-il clair dans le premier paragraphe ?
- Les prérequis sont-ils avant les instructions ?
- Le lecteur peut-il vérifier le succès ?
- Les exemples sont-ils réels et copiables ?
- La page renvoie-t-elle à la tâche suivante au lieu de la répéter ?

## Étapes suivantes

- [Créer et éditer des pages](/guides/writing-content)
- [Référence du frontmatter](/guides/frontmatter-reference)
- [Organiser votre navigation](/guides/configuring-navigation)