Fix doc build report errors: code-block-indented

- fixup markdown errors
- improve readability score
- fix table renderings
- fix code indention errors

Author: andrewconnell