Move Annotations introduction to the reference.
Refactor Basic Mapping chapter to focus on the actual topic more. Rearrange apperance of topics. Introduce a sane example entity as example.
Move Custom Mapping Types into cookbook, restructure the chapter more.
Small fixes in basic-mapping.rst
Fix some more details in basic-mapping.rst
fix warnings p1

fix warnings p2

fix warnings p3

fix warnings p4
Merge pull request #784 from eventhorizonpl/fix_docs

fix documentation warnings p1