Developer-contributed notes are a long-standing open-source tradition; see any page in the PHP or MySQL manuals, for example. As all programmers know, API documentation is fine, but when we're crunched for time (always) what we really need is a good example or two.
Enter Developer Notes. Currently up and running on most of the individual API calls under Answers, Search, and Utilities, Developer Notes are ready to serve. Before diving in, please read the full story on the Developer Notes page, just off the main Community area. (The short version: yes, you'll need to sign in to contribute notes; submitted notes will be moderated for quality and relevance; and requests for technical support will be gently redirected to their proper place, the individual Yahoo! group for the API family in question.)
Kent Brewster, Yahoo! Developer Network