Wave the docs vaguely in the direction of being more correct
More attempts at fixing wrongness
Merge pull request #54 from aidanhs/aphs-gh-pages-update

Some doc fixes