Added sphinx documentation directory.

Structure initially created using the sphinx-apidoc tool
and then edited to suit this package.
Tweaked documentation so that it builds correctly.

Put attribute documentation inline.

Prevented __init__ methods being skipped.

Moved comments about starlink.ndf and starlink.hds into the
files describing those packages.