Re: The kind of documentation people like

2013-03-06 Thread Jesse Phillips
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. I notice in the their dev

Re: The kind of documentation people like

2013-03-06 Thread Denis Koroskin
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. For what it's worth, MSDN

Re: The kind of documentation people like

2013-03-06 Thread Jakob Ovrum
On Wednesday, 6 March 2013 at 21:11:36 UTC, Brad Anderson wrote: Sönke Ludwig made ddox which does this. Phobos example: http://vibed.org/temp/d-programming-language.org/phobos/index.html Pull request: https://github.com/D-Programming-Language/d-programming-language.org/pull/267 bootDoc also

Re: The kind of documentation people like

2013-03-06 Thread Brad Anderson
On Wednesday, 6 March 2013 at 19:58:36 UTC, H. S. Teoh wrote: Another thing I find frustrating with Phobos docs is the lack of navigability. A large module can easily have 30-50 functions, and putting detailed docs for each one on a single page is a bad idea. I think somebody did up a version w

Re: The kind of documentation people like

2013-03-06 Thread H. S. Teoh
On Wed, Mar 06, 2013 at 12:05:18PM +0100, Chris wrote: > 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 > >document

Re: The kind of documentation people like

2013-03-06 Thread MattCodr
On Wednesday, 6 March 2013 at 08:17:58 UTC, Walter Bright wrote: What I get from this is that people really like PHP's documentation style where users can add to it. Of course, plus the rank system, (where the best answers appears first), you "almost" have a winner. I said "almost", because

Re: The kind of documentation people like

2013-03-06 Thread 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 goo

The kind of documentation people like

2013-03-06 Thread Walter Bright
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.