Put the canonical import path into the main directory, to
centralise it, and make sure it's applied across everything.

As a side effect of this work, also added some more package docs.