diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b505797
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# Cours visualisation - notreHistoire.ch (projet de Mathias Winiger)
+
+## Descriptif
+
+### Contexte de la problématique
+Ce projet de visualisation s'inscrit dans la continuité de mon travail de mémoire d'histoire et d'humanités numériques. Dans ce travail, je me suis interrogé sur la transformation d'archives privées en des éléments d'une histoire partagée. J'ai pour cela analysé la plateforme numérique participative notreHistoire.ch.
+
+Éditée depuis 2009 par la FONSART, cette plateforme invite des institutions, mais aussi des amateurs et des amatrices à publier leurs archives afin de constituer une histoire partagée de la Suisse romande. Aujourd'hui, la plateforme compte plus de 112'000 publications, dont une majorité de photographies. Lors de leur mise en ligne, les utilisateurs et utilisatrices sont encouragé-e-s à contextualiser leurs documents, notamment par l'ajout de coordonnées. De plus, la web-édition sélectionne et met en valeur quotidiennement des contenus sur la page d'accueil du site - ce sont les "repérages" de notreHistoire.
+
+J'ai souhaité créer une visualisation de données afin de montrer quelles sont les régions les plus documentées et mises en valeur sur cette plateforme. 
+
+### Données
+Dans le cadre de mon travail de mémoire, j'ai récolté grâce à l'API (https://notrehistoire.ch/api/v1) toutes les données relatives aux 112'000 documents publiés sur ce site. Ces publications sont pourvues de nombreuses métadonnées, dont d'éventuelles coordonnées ainsi qu'un statut *featured*, qui correspond aux "repérages" de la web-édition.
+Mon projet de visusalisation a pris en compte les 30'114 publications géolocalisées (coordonnées longitudinales et latitudinales) en date du 30 avril 2024. De plus, chacune de ces entrées à une variable A/B qui correspond soit à une publication standard (A) ou à une publication mise en "repérage" (B). Au total, 26'698 documents géolocalisés ont le statut "standard" et 3'415 documents géolocalisés ont le statut "repérage". Quant à la qualité de ces données, elles dépendent du soin apporté par les personnes qui publient et contextualisent leurs documents. Sa fiabilité est donc liée à la qualité du travail des membres de notreHistoire.
+
+### Choix de la visualisation
+La nature du projet notreHistoire m'a naturellement poussée à créer une visualisation représentant une carte de la Suisse. J'ai d'abord réfléchi à créer des "cluster" plus ou moins grands en fonction du nombre de documents rattachés à certaines régions, mais cela impliquait des choix arbitraire liés à la définition de périmètres. Il m'a semblé plus opportun de représenter toutes ces publications par des points uniques. La superposition de ces points peu saturés révèle avec une plus grande subtilité quelles sont les régions les plus représentées sur cette plateforme. En outre, j'ai décidé de différencier les publications standard et les publications "repérages" par des checkboxes afin de montrer l'action éditoriale des web-éditeur-ice-s de notreHistoire. 
+
+### Interprétation des résultats
+Cette visualisation montre que les documents géolocalisés de notreHistoire représentent en grande majorité la Suisse romande, et en particulier la ville de Genève, l'arc lémanique et la plaine du Rhône. Les "repérages" se concentrent majoritairement autour de Genève, Lausanne, Vevey, Montreux, Fribourg, et le Valais central. Les cantons du Jura et du Jura bernois sont, quand à eux, relativement peu représentés. 
+
+### Limites interprétatives et développement futur
+Cette visualisation offre avant tout une impression. Elle ne donne aucun chiffre et pourrait être davantage informative, par exemple par l'ajout d'un tableau indiquant le nombre de publications associées à chaque canton. L'idée d'une représentation par clusters pourrait également offrir une interprétation plus informative. De plus, mon jeu de données est "figé" - il s'arrête au 30 avril 2024. Cela soulève des questions quant à l'actualisation de cette visualisation.
+
+## Sources
+
+- d3 version 4
+- d3 geoProjection
+- d3 scale-chromatic
+- Carte Suisse tirée de https://github.com/zcreativelabs/SfGZ-d3-map
+- Code inspirée du projet "Where surfers live" de Yan Holtz https://www.data-to-viz.com/story/GPSCoordWithoutValue.html
+
+