Add policy to the README about inline markup and heading/subheading

Also two minor fixes in the index of the developer documentation
Fix numerous punctuation and spelling errors
Fixed forward declartion incomplete type error in c++ example code
merge dev_4_4 -D org -I include -E conflict -E needs-fixes -E broken: PR 179 (CLI documentation)
merge dev_4_4 -D org -I include -E conflict -E needs-fixes -E broken: PR 193 (Tables documentation partial rewrite 9957)
merge dev_4_4 -D org -I include -E conflict -E needs-fixes -E broken: PR 198 (Update Windows docs (see #10095))
merge dev_4_4 -D org -I include -E conflict -E needs-fixes -E broken: PR 206 (Fixed forward declartion incomplete type error in c++ example code)
merge dev_4_4 -D org -I include -E conflict -E needs-fixes -E broken

Repository: openmicroscopy/ome-documentation
Updating 858e9f2..0250249
Merged PRs:
  # PR 179 sbesson 'CLI documentation'
  # PR 193 manics 'Tables documentation partial rewrite 9957'
  # PR 198 bpindelski 'Update Windows docs (see #10095)'
  # PR 206 dpwrussell 'Fixed forward declartion incomplete type error in c++ example code'

Generated by OMERO-merge-4.4#114 (http://hudson.openmicroscopy.org.uk/job/OMERO-merge-4.4/114/)