fix inconsistent capitalisation and include link to documentation repo (to be replaced with link to docs after launch)