further doc enhancements
changed test.py in examples directory