DOCUMENTATION: Making restructured text recognized by github.
DOCUMENTATION: Cleaned up the documentationed

Made some clarifications.  Edited the restructured text.