Créer et modifier des documents
Les documents dans AB Projects sont des pages Markdown avec un historique de versions complet. La création et la modification se font dans un panneau latéral avec un aperçu en direct, et chaque changement est enregistré afin que l'équipe sache toujours ce qui a changé et pourquoi.
Créer une page
- Dans l'espace Documents du projet, démarrez une nouvelle page. Donnez-lui un titre, un chemin parent facultatif (par défaut
/— définissez quelque chose commeonboardingpour l'imbriquer), et des tags facultatifs. - Rédigez le corps en Markdown. L'éditeur affiche un aperçu en direct à côté de la source afin que vous puissiez voir le résultat rendu au fur et à mesure que vous tapez.
- Enregistrez pour publier la page dans l'arborescence. Elle devient la version 1.
Modifier une page
- Ouvrez une page et choisissez Modifier (depuis le menu d'actions de la page). Le même panneau s'ouvre avec le Markdown actuel.
- Une note de modification est requise lorsque vous effectuez une modification. Avant d'enregistrer un changement, vous devez saisir une courte note décrivant ce qui a changé — si vous la laissez vide, AB Projects vous demande d'en ajouter une « afin que votre équipe sache ce qui a changé ». (Les nouvelles pages n'ont pas besoin de note ; les modifications, si.)
- L'enregistrement crée une nouvelle version plutôt que d'écraser — la version précédente est conservée.
Historique des versions et restauration
- Chaque page suit un numéro de version ainsi que le dernier éditeur et l'heure.
- Ouvrez Historique depuis le menu d'actions de la page pour voir les versions passées, chacune avec sa note de modification — ainsi le « pourquoi » de chaque changement est consigné.
- Vous pouvez restaurer une version antérieure depuis la liste de l'historique. La restauration ramène ce contenu en tant que page actuelle (et est elle-même enregistrée comme une nouvelle version).
Supprimer une page
- Supprimer est disponible depuis le menu d'actions de la page, délibérément placé à l'écart de Modifier/Historique afin de ne pas être cliqué par accident.
- La suppression retire la page de l'arborescence. Considérez-la comme une action à effectuer avec précaution — préférez la modification ou la restauration à la suppression lorsque vous avez simplement besoin de changer le contenu.
Conseils
- Utilisez le chemin parent pour construire une structure claire (par exemple
engineering/runbooks) plutôt qu'une liste plate de pages. - Rédigez des notes de modification pertinentes — ce sont elles que l'Historique affiche et sur lesquelles les coéquipiers s'appuient pour comprendre un changement sans comparer les différences.
- Utilisez l'aperçu en direct pour vérifier la mise en forme (titres, blocs de code, liens) avant d'enregistrer.
- Si une modification s'est mal passée, restaurez la version précédente depuis l'Historique plutôt que de réécrire de mémoire.
Avec le Markdown, l'aperçu en direct, les notes de modification obligatoires et l'historique complet avec restauration, les Documents restent faciles à rédiger et sûrs à modifier.