[BACKLOG-197] Refactored comments for uniformity accross the documentation.
Merge pull request #1869 from brendan-lynch/oemdoc-dev

[BACKLOG-197] Refactored comments for uniformity accross the documentati...