The kind of documentation people like

[Chris]

On Wednesday, 6 March 2013 at 08:17:58 UTC, Walter Bright wrote:
> http://www.reddit.com/r/programming/comments/19npsp/developers_may_be_getting_as_much_as_50_of_their/
>
> What I get from this is that people really like PHP's 
> documentation style where users can add to it.

Stackoverflow is very good when it comes to specific questions. 
With the PHP documentation it sometimes takes a while until I 
find an example of what I need to do. I think a very good way is 
to include examples in the documentation where it makes sense. 
The Cocoa documentation does that and also the D Library 
Reference. I like the "Synopsis" part.