Clean up ci yaml doc [ci skip]

* Fix headings so that they are picked up by doc.gitlab.com
* Stick to 80 characters
* Clean up some examples