Update development docs

Sascha Klawohnrequested to merge
1628-update-development-docs into develop

Fix typos, unify names, clean up formatting.

Closes #1628 (closed)

Merge request reports