rewrite some examples and bring in new ones parsed from the docs

This goes hand in hand with https://github.com/cfengine/documentation/pull/269
Please don't merge unless the documentation PR is approved.