Thread overview | |||||
---|---|---|---|---|---|
|
May 23, 2013 ddox based reference on dlang.org | ||||
---|---|---|---|---|
| ||||
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 23, 2013 Re: ddox based reference on dlang.org | ||||
---|---|---|---|---|
| ||||
Posted in reply to Brad Anderson | 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 23, 2013 Re: ddox based reference on dlang.org | ||||
---|---|---|---|---|
| ||||
Posted in reply to Jonathan M Davis | 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 |
Copyright © 1999-2021 by the D Language Foundation