www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - ddox based reference on dlang.org

reply "Brad Anderson" <eco gnuk.net> writes:
Whatever happened to the plan of getting Sönke Ludwig's ddox 
generated documentation up on dlang.org?

http://vibed.org/temp/d-programming-language.org/phobos/std/algorithm.html

I see there are pull requests to add it:

https://github.com/D-Programming-Language/dlang.org/pull/267
https://github.com/D-Programming-Language/tools/pull/43

I can't immediately tell if they are ready to pull or not.  
Better documentation was one of the main criticisms I've gleaned 
from the DConf videos released thus far so any improvements in 
this area should probably get merged sooner than later.

(I'm personally looking forward to the day I can stop explaining 
to confused people that the link to the remove function in 
std.algorithm is actually taking you to an unrelated enum)
May 22 2013
parent reply "Jonathan M Davis" <jmdavisProg gmx.com> writes:
On Thursday, May 23, 2013 02:52:44 Brad Anderson wrote:
 Whatever happened to the plan of getting Sönke Ludwig's ddox
 generated documentation up on dlang.org?
 
 http://vibed.org/temp/d-programming-language.org/phobos/std/algorithm.html
 
 I see there are pull requests to add it:
 
 https://github.com/D-Programming-Language/dlang.org/pull/267
 https://github.com/D-Programming-Language/tools/pull/43
 
 I can't immediately tell if they are ready to pull or not.
 Better documentation was one of the main criticisms I've gleaned
 from the DConf videos released thus far so any improvements in
 this area should probably get merged sooner than later.
 
 (I'm personally looking forward to the day I can stop explaining
 to confused people that the link to the remove function in
 std.algorithm is actually taking you to an unrelated enum)

That stuff is definitely going to be merged in (Andrei said as much at dconf), but I don't know what needs to be done before it's ready to be merged. - Jonathan M Davis
May 22 2013
parent Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
On 5/22/13 11:16 PM, Jonathan M Davis wrote:
 On Thursday, May 23, 2013 02:52:44 Brad Anderson wrote:
 Whatever happened to the plan of getting Sönke Ludwig's ddox
 generated documentation up on dlang.org?

 http://vibed.org/temp/d-programming-language.org/phobos/std/algorithm.html

 I see there are pull requests to add it:

 https://github.com/D-Programming-Language/dlang.org/pull/267
 https://github.com/D-Programming-Language/tools/pull/43

 I can't immediately tell if they are ready to pull or not.
 Better documentation was one of the main criticisms I've gleaned
 from the DConf videos released thus far so any improvements in
 this area should probably get merged sooner than later.

 (I'm personally looking forward to the day I can stop explaining
 to confused people that the link to the remove function in
 std.algorithm is actually taking you to an unrelated enum)

That stuff is definitely going to be merged in (Andrei said as much at dconf), but I don't know what needs to be done before it's ready to be merged. - Jonathan M Davis

Yah, we'll merge that. It's a big change so I need to reserve a considerable chunk of time to get it in. And before that I need to merge my own pull https://github.com/D-Programming-Language/dlang.org/pull/271 which fixes a number of issues; not sure how that will interact with the other. Andrei
May 22 2013