OMERO Developer doc tidying

Addressing a multitude of minor issues and general formatting.

More to come on other PRs, trying to keep each one to a reasonably reviewable chunk!