Docs cleanups

Includes a Python code cleanup, removal of reference to Python 2.5
and some visual improvements.