> Are there any guidelines anywhere on what we are going for in a man > page? If not is there a page which is very good and can be held up as a > standard?
Ingo's EuroBSDCon 2014 tutorial slides might be a good place to start: https://www.openbsd.org/papers/eurobsdcon2014-mandoc-slides.pdf It should contain all the important pointers and while mandoc has evolved since then, I think it shouldn't be too outdated. One of my favorite pages is the (relatively) new sh(1) manual, but usually things aren't that complex :)
