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