[sublinear]

They know the man pages exist and they want to use them, but most are written to merely be consistent in format and not necessarily in content. The worst thing to omit is examples.

What users do nowadays is rely on alternatives such as https://tldr.inbrowser.app/

[voidfunc]

This is my experience with manpages, they're great if you sort of know what you need or want deep CLI options reference but often lack in recipes or examples.

[dingosity]

man -k