Comment by sgs1370

Why don't man pages have more examples, is it because of space, or the work to maintain them (including making sure they still work?)

Although man pages is where I go for the syntax and option definitions, stack-overflow has become my go-to place for examples. I think this "bro pages" is an attempt to fill a need but if the tool-owner is willing, a man page approved by the owner seems like it will be more authoritative.

Man pages seem like a great place for people who want to contribute to open-source to try and submit patches containing examples (unless examples are prohibited by most patch-approvers). I hate writing documentation, including examples, so I won't be adding in either spot, but lots of people on stack-overflow seem to have a desire and some have a knack for it.