Re: Documenting an API
That's a good question. There's so much variety (and certainly more that's so-so than great). Check-out the Flickr docs.
Also, try Digg
If you want others let me know and I can get you more ideas.