fixed a few things in examples and documentation
minor docstring changes