Docs update

Markup updated, outdated parts updated, missing example added.