diff --git a/README.md b/README.md
index a65bbed..ca6f94e 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,22 @@
+Description
+===========
+
+
+
+
 TODO
-----
+====
+
+Documentation
+-------------
+
+* add usage scenario
+* clarify tree of rights
+* clarify why the dependencies need to be managed in the service (to avoid to break the
+CRUD model, *i.e.* reppsitory methods are specialised to load the one-level 
+dependencies, thus cannot be used to load object as dependencies  
 
-* Add usage scenario
-* Clarify tree of rights
-* Tests for one-level dependencies
+Tests
+-----
 
+* tests for one-level dependencies
\ No newline at end of file
--
libgit2 0.21.2