cleanup documentation, moving things from cmf doc here
Merge pull request #241 from sonata-project/update-doc

cleanup documentation, moving things from cmf doc here