Re:TLDR pages: Simplified, community-driven man pages
by fhennig on Wednesday January 22, 2020 @02:16PM
(#22120961)
Yes, put both things in the man page!
Looking at some examples of tldrs, it mostly boils down to the most common use cases as examples. So well written man pages already have an "examples" section, and that really helps!
I don't see why they could not serve both purposes.
Man pages should start with a tldr section followed by the full reference/spec.