Generate docs not from an already installed pysam

Before, sys.path manipulation led to an already installed pysam version be
picked up by sphinx. Now, only the one in the build/ directory is used.
Describe how to build documentation
improve AlignedRead documentation
validate() method is not implemented