small improvements to example py-scripts
some documentation on the arc code