Well, documentation always lags behind development. There are (at least two) reasons for this:
1) Developers hate writing it.... very few people read it anyways (esp. end user documentation). we'd rather show
by example than spend time writing docs that people won't read anyways. They'll still just ask the questions.
Some people can't even click on the documentation that already exists where certain questions are clearly and plainly answered,
they'd rather post a question in the forum that is vague, and then get ticked when nobody responds.
(sorry, I'm a quited annoyed about that of late).
2) We've usually got somebody breathing down our necks for the code we're writing and focus on getting the code working
and then ship it out and go on to the next issue.
3) Because of the above two reasons, the docus (even developer docs) lag behind the code, and tend to get out of date very
quickly.... which makes the problem even worse.
Now, stating that, the docs still need working on. And the only way to do it is collaberatively. Setting up policies, rules, and guidelines doesn't work (nobody reads them either, not even the developers).
So I would suggest, that as you need something, a) ask the question, b) put something into the wiki in the appropriate spot, c) tell people about it so that they can fill in the blanks, expand a bit, correct your spelling mistakes, etc, etc.) and hopefully the community we have here can write their own docs. We have a wonderful user community, it's just a a few people who are lazy and/or inconsiderate that tick us off.
Regarding examples
Well... I've just recently written the NewsToCalendar module (looks like there's still a few burs to be ground off of it yet). but it's essentially a bridge between (you guessed it), News and calendar. it handles six of the News module events, and performs actions on the Calendar database.
As well there's News which both sends, and handles events (it handles search this way). as well as the Uploads module, and the Search module itself.
Events are so cool, why didn't I think of that earlier
