diff --git a/user/00000-toc.md b/user/00000-toc.md
new file mode 100644
index 0000000..80fdc7e
--- /dev/null
+++ b/user/00000-toc.md
@@ -0,0 +1,177 @@
+
+# Qu'est-ce que Chill ?
+
+## A quoi ça sert ?
+
+=~ dossier social électronique
+
+### Objectifs
+
+* consigner les informations;
+* partager avec les collègues;
+* générer des statistiques.
+
+Chill n'est pas un logiciel de statistique. Il est pensé pour être utilisé au quotidien, et générer des statistiques à partir de cette utilisation.
+
+## Comment l'installer
+
+Renvoi à la documentation technique
+
+## Comment l'administrer ?
+
+Renvoi à la documentation administrateur
+
+# Survol des concepts dans Chill
+
+Les trois domaines dans Chill.
+
+Chaque domaine est caractérisé par son bandeau, et son menu.
+
+<!-- ici, c'est un survol. renvoi vers les parties plus détaillées -->
+
+## Fiche usager
+
+## Fiche ménage
+
+## Fiche parcours
+
+# L'interface générale
+
+## Boutons et codes couleurs
+
+<!-- récapitulatif des boutons et codes couleurs -->
+
+* vert: ajouter / créer
+* bleu (oeil): voir
+* etc.
+
+<!-- voir la première page du manuel fait par SB -->
+
+### select2js et multiselect
+
+## Menu section
+
+## Menu utilisateur
+
+# Moteur de recherche
+
+## Recherche directe
+
+Possibilité de recherche par date de naissance, numéro de téléphone, etc.
+
+## Recherche avancée
+
+
+# Fiche usager
+
+## Créer un usager
+
+## Détails de l'usager
+
+## Quelle adresse pour un usager ?
+
+Différence entre les adresses de résidence et les adresses d'un ménage.
+
+## Personnes ressources
+
+## Adresses de résidence
+
+## Historique
+
+## Traiter les doublons
+
+## Autres entrées dans le menu personne
+
+Renvoi vers les partie ad hoc:
+
+* activité
+* rendez-vous
+* documents
+
+# Activités (échanges)
+
+## A quoi ça sert ?
+
+## Activité dans les personnes ou les parcours ?
+
+## Créer et modifier une activité
+
+## Effets de la sélection des problématiques ou des actions sur les parcours
+
+# Documents
+
+## A quoi ça sert ?
+
+## Ajouter un document
+
+## Générer un document
+
+# Rendez-vous
+
+TODO
+
+# Tâches
+
+## Principes des tâches
+
+### Statuts sur les tâches
+
+### Tâches en rappel, tâches arrivées à échéance
+
+## Créer une tâche
+
+# Parcours
+
+## Qu'est-ce qu'un parcours ?
+
+### Les étapes d'un parcours: brouillon, confirmé, etc.
+
+### Problématiques et actions
+
+### Parcours confidentiels
+
+### Parcours réguliers et ponctuels
+
+## Créer un parcours
+
+## Commentaires dans les parcours
+
+## Actions d'accompagnement
+
+### Evaluations et objectifs
+
+## Cloturer un parcours
+
+# Ménages
+
+## Qu'est-ce qu'un ménage ?
+
+### Les positions dans le ménage
+
+<!-- attention, les positions "enfants hors ménage", etc., c'est de la configuration -->
+
+## Ajouter des membres au ménage, quitter un ménage, rejoindre un ménage
+
+## Filiations
+
+## Composition familiale
+
+# Notifications
+
+## Créer une notification
+
+## Discuter dans une notification
+
+# Workflows
+
+## Créer un workflow
+
+## Ajouter une décision à un workflow
+
+## Rejoindre un workflow par un lien d'accès
+
+# Activité annexes
+
+# Choisir une adresse
+
+
diff --git a/user/_a-classer.md b/user/_a-classer.md
new file mode 100644
index 0000000..7ba8acf
--- /dev/null
+++ b/user/_a-classer.md
@@ -0,0 +1,11 @@
+
+## Fonctionnement du moteur de recherche des tiers:
+
+Le moteur de recherche des tiers dans "add person" permet d'effectuer des recherches sur les noms des tiers, les acronymes, et leur service. Il classe également les plus pertinent, en tenant compte éventuellement du nom de la localité du tiers, s'il possède une adresse.
+
+Le moteur sélectionne d'abord les tiers sur base du nom, de l'acronyme ou du nom du service. Lorsqu'une recherche comporte plusieurs mots (séparés par un ou plusieurs espaces), il sélectionne les tiers dont le nom, l'acronyme ou le nom du service contient un de ces mots seulement.
+
+Le moteur affiche les résultats les plus pertinents en premier. Il classe en premier les tiers dont le mot recherché correspond à un des mots du nom, de l'acronyme, ou du nom du service, **ou de la localité du tiers**. Cela permet donc de présenter en premier les tiers dans une localité particulière.
+
+Ainsi, si une recherche est effectuée avec les termes `ADMR roche`, tous les résultats dont l'acronyme est ADMR sont renvoyés. Cependant, les tiers dont la localité est La-Roche-Sur-Yon seront considérés plus pertinents (ils disposeront de deux mots qui correspondent (`admr` et `roche`) plutôt qu'un seul); ils seront donc présentés en premier.
+
diff --git a/user/adresses.md b/user/adresses.md
new file mode 100644
index 0000000..41b6819
--- /dev/null
+++ b/user/adresses.md
@@ -0,0 +1,14 @@
+# Adresses, usagers et ménages
+
+Chill supporte deux types d'adresses:
+
+* les adresses de domicile, qui sont les adresses permanentes, officielles, d'un usager (adresse de domicilation);
+* les adresses de résidences, qui sont des adresses temporaires d'un usager, auquel il ne réside que pour une période de temps déterminée, et qui n'est pas destinée à être officielle.
+
+## Adresses de résidences
+
+Chaque usager peut indiquer une ou plusieurs adresses de résidences.
+
+Ces adresses ne sont pas censées être des adresses de domicile, officielles, déclarées auprès des autorités. Il s'agit, par exemple, d'une résidence temporaire en maison de repos, d'un logement chez une connaissance ou un ami pendant une période de temps déterminée, etc.
+
+