updating internal documentation to conform to sphinx ReST format