Aller au contenu

Version imprimable multipages. .

Retour à la version par défaut.

Introduction

Comprendre le projet et les idées qui le guident.

Commencez ici si vous découvrez le projet.

1 - Vue d’ensemble du projet

Expliquer ce que fait le projet, à qui il s’adresse et pourquoi il existe.

Remplacez cette page par l’explication la plus courte et utile de votre projet.

Le problème

Décrivez le problème avec les mots du lecteur. Évitez les détails d’implémentation tant que la valeur du projet n’est pas claire.

Le résultat

Expliquez ce qu’un utilisateur peut accomplir après avoir adopté le projet.

Astuce

Une bonne vue d’ensemble aide le lecteur à décider en moins de deux minutes s’il souhaite continuer.

2 - Architecture

Donner au lecteur un modèle mental stable du projet.

Documentez les quelques composants qu’un contributeur doit comprendre avant toute modification.

Carte du système

PartieResponsabilité
InterfaceReçoit les entrées et présente les résultats
CœurApplique les règles du projet
AdaptateursRelient les systèmes externes

Limites

Indiquez ce que le projet ne prend volontairement pas en charge. Des limites claires évitent de promettre plus que le logiciel ne fournit.