update docs to minimise the use of heading1 and heading2 so that things fill up the pages a little better in the generated pdf
fix likes/watchers links on gitbook
tidied up the docs so that it generates a better PDF