update readme
add initial sphynx documentation
add the class attributes into the docstrings rst description
minor corrections
Merge pull request #28 from enthought/documentation

Documentation