Module format and doc: tidy up (#2502)

* developing_modules_documenting.rst: tidy up

Co-authored-by: Don Naro <[email protected]>
Co-authored-by: Alexei Znamensky <[email protected]>
Co-authored-by: Sandra McCann <[email protected]>

Author: 4 people