MaisonMix 2016/Canevas de documentation

Structure possible pour documenter un projet de MaisonMix.

Résumé du projet

En quelques phrases, un résumé attractif et expliquant le projet, son public cible, son objectif, son fonctionnement. Imaginer que l'on s'adresse à quelqu'un qui ne connaît pas le sujet et que l'on veut convaincre.

+ une illustration

Comment ça fonctionne ?

Cette partie décrit le fonctionnement du projet de façon simple, pour quelqu'un qui aimerait comprendre comment marche le projet.

Le service proposé

Décrire les services proposés.

Scénario utilisateur

Un exemple d'utilisation du projet, mettant en scène des personnes dans leur contexte habituel. Comment ils s'approprient le service, comment ils interagissent avec l'objet.

Les aspects techniques

Présenter succintement les technologies utilisées. Ajouter des images, captures d'écran... pour que le lecteur visualise à quoi ressemble le prototype.

Ne pas hésiter à rajouter des sous-sections.

Comment ça fonctionne en détail ?

Cette partie décrit le fonctionnement du projet de façon détaillée, pour une personne qui aimerait comprendre les détails techniques, reproduire ou améliorer le prototype... On y donner accès aux ressources (code source, plans...)

Ne pas hésiter à rajouter des sous-sections.

Comment nous en sommes arrivés là ?

Cette partie détaille les réflexions de l'équipe autour du projet.

Le constat initial

• Le public visé
• Quels sont ses besoins ?
• Problématiques envisagées
• Problématique retenue (comment faire pour ?)

Le processus de réflexion

Résumer les échanges et questionnements qui se sont déroulés pendant le brainstorming.

L'équipe

Qui êtes-vous ?

Mettre les prénoms, noms, adresses mails, réseaux sociaux... en fonction de ce que les personnes préfèrent, s'ils souhaitent être contactés ou non.

Mettre une photo de l'équipe

Ressources

Liens externes, inspirations, liens vers des projets similaires, ressources qui vous ont aidées à réfléchir...

Galerie de photos de l'équipe et du projet