Going on with documentation

* Documentation should reflect current code base
* Documentation should be as complete as possible, even if some concepts are dropped in a near futur
* Future refactoring and strategies changes will be easier to understand and review if the documentation is modified accordindly
"and a policy (optional)"