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.