Developer Docs tidy (rebased onto develop)



This is the same as gh-239 but rebased onto develop.

----

To fix typos and self-linkage etc left over from move from Trac wiki. 
Also addressing https://trac.openmicroscopy.org.uk/ome/ticket/10213