docs; fix examples

fixes #1583