Notes du projet et spécification

Yorki garde en mémoire les informations sur ton projet dans la vue Projet, pour qu’une demande faite plusieurs semaines plus tard tienne toujours compte des décisions prises auparavant. Cette mémoire comprend deux parties : la spécification, que tu rédiges, et les notes du projet, que Yorki tient à jour.

La spécification

La spécification est ton document. Chaque demande en mode Construire, Discussion ou Plan la consulte en premier, et elle prime sur les notes et le code. Utilise-la pour définir les règles que ton application doit toujours respecter :

• « Les prix sont toujours affichés en euros, TVA comprise. »
• « Seuls les membres peuvent voir le calendrier des formations. »
• « Tous les textes doivent adopter un ton amical et informel. »

Ouvre Projet, puis appuie sur Écrire, ou sur Modifier si le document contient déjà du texte. Appuie sur Enregistrer, ou utilise ⌘S sur Mac et Ctrl+S ailleurs. La touche Esc annule l’opération. Chaque enregistrement crée une version « Modification de la spécification », gratuitement.

Tu es la seule personne à pouvoir rédiger la spécification. La mise en œuvre d’un plan ne la modifie jamais : le plan reste dans la discussion et Yorki consigne ce qu’il a créé dans les notes du projet. Si une décision prise dans un plan doit toujours s’appliquer, ajoute-la toi-même ici.

Veille à ce qu’elle reste concise. Chaque demande consulte l’intégralité de la spécification, et Yorki t’avertit lorsqu’elle devient très longue.

Les notes du projet

Sous la spécification se trouvent trois notes que Yorki rédige et met à jour après chaque demande :

• Projet : ce qu’est l’application, à qui elle s’adresse et les décisions prises jusqu’ici.
• Architecture : comment l’application est construite, ses pages et les données qu’elle conserve.
• Feuille de route : ce qui a été fait et ce qui pourrait suivre.

Tu peux les lire et les copier, mais pas les modifier. Une ligne sous les notes indique si la dernière demande les a mises à jour. Chaque mise à jour apparaît dans l’historique des versions sous le nom « Mise à jour des notes ». Tu peux l’annuler séparément, sans modifier ton application.

Services externes

Si ton application fait appel à d’autres services, comme un service de cartographie ou de météo, ils sont répertoriés sous Services externes dans la même vue.