First draft for the V2 documentation
Fixes for expliciteness and consistency.
copy change API docs
hide v2 documentation for now and show v1 documentation as default
add v1 docs back
Merge pull request #1 from publitas/apiv2

[MERGE] API V2 docs.