We should move the documentation into a separate folder. The advantage of this is it can then be deployed. See Readthedocs or the GitHub wiki.
It will also involve separating technical documentation from the open source docs which are meant for different types of users.