News for hackers. Stuff that matters.
Re:TLDR pages: Simplified, community-driven man pages by SaulOfTheJungle on Wednesday January 22, 2020 @02:10PM (#22120889)
> No, they serve two different purposes.

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.

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!