documentation of annotations
added new sections, index refactoring
more improvements to concepts,use and create javatweeks section
improved rest interface and basic concepts adding diagrams
add consumer page
Merge pull request #233 from Damianofds/master-doc-improved

Documentation Improvements