doc: fix invalid path doc comments
Affected core subsystem(s)
doc, path
Description of change
The format of certain code comments in the path
documentation results
in the code blocks being invalid. I also find it confusing at least as
formatted on the website. This change is intended to improve those
comments.