Better docs

* headings and examples fixed