diff --git a/README.md b/README.md
index 960c5caa..9907bc0f 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,27 @@
 This is the repository for all user contributed stuff
 
-* contrib/tools/ is for 3rd-party tools. It usually serves as an incubator of trunk/contrib.
-* contrib/plugins/ is for 3rd-party plugins. It will serve as the backend of exchange.munin-monitoring.org when it is operational again.
-* contrib/templates/ is for 3rd-party templates. Feel free to update templates, or even to create new ones. Bonus points for mobile-friendly ones :)
+# contrib/plugins/ - 3rd-party plugins
+
+**This is usually where you want to begin your journey.**
+
+Here you'll find all the plugins coming from http://exchange.munin-monitoring.org/. 
+It as evolved since then, but 
+
+# contrib/templates/ -  3rd-party templates
+
+Feel free to update templates here, or even to create new ones.
+
+Bonus points for mobile-friendly ones :)
+
+Note that the one named `official` is a loose-synced copy of the one in SVN trunk. 
+It should serves as a base for small editions that can be resynced in SVN trunk, so for that : 
+
+* don't copy the whole template
+* directly edit files in this directory
+
+# contrib/tools/ - 3rd-party tools
+
+Here, you can put just any kind of tool. Please use this directory instead of a random place on the internet. 
+It makes things way more easy to search for others.
+
+And, it serves as an incubator of SVN `trunk/contrib` :-)