I use this experimental sample website regularly for Phobos documentation because it's organized much better than what is on the official website.

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

Of course it's better to have the official website directly host an improved format, but I don't know if that's a huge undertaking or not, so in the meantime
I'd rather not wait for something like it to materialize in here because I have real work to do and it's a productivity booster, so is it possible to have the vibe.d website updated to the latest documentation? It'll be appreciated greatly if this can be done, thanks!


--rt

Am 20.02.2013 18:45, schrieb Rob T:
> I use this experimental sample website regularly for Phobos documentation because it's organized much better than what is on the official website.
> 
> Example: http://vibed.org/temp/d-programming-language.org/phobos/std/array.html
> 
> Of course it's better to have the official website directly host an
> improved format, but I don't know if that's a huge undertaking or not,
> so in the meantime
> I'd rather not wait for something like it to materialize in here because
> I have real work to do and it's a productivity booster, so is it
> possible to have the vibe.d website updated to the latest documentation?
> It'll be appreciated greatly if this can be done, thanks!
> 

I've updated the docs now. There is also a pull request to start getting
them on dlang.org
<https://github.com/D-Programming-Language/d-programming-language.org/pull/267>.

On Wednesday, 20 February 2013 at 22:14:16 UTC, Sönke Ludwig wrote:
> Am 20.02.2013 18:45, schrieb Rob T:
>> I use this experimental sample website regularly for Phobos
>> documentation because it's organized much better than what is on the
>> official website.
>> 
>> Example:
>> http://vibed.org/temp/d-programming-language.org/phobos/std/array.html
>> 
>> Of course it's better to have the official website directly host an
>> improved format, but I don't know if that's a huge undertaking or not,
>> so in the meantime
>> I'd rather not wait for something like it to materialize in here because
>> I have real work to do and it's a productivity booster, so is it
>> possible to have the vibe.d website updated to the latest documentation?
>> It'll be appreciated greatly if this can be done, thanks!
>> 
>
> I've updated the docs now. There is also a pull request to start getting
> them on dlang.org
> <https://github.com/D-Programming-Language/d-programming-language.org/pull/267>.

Hey, that was quick, thanks a bunch! :)

--rt

On Wed, 2013-02-20 at 23:13 +0100, Sönke Ludwig wrote:
> Am 20.02.2013 18:45, schrieb Rob T:
> > I use this experimental sample website regularly for Phobos documentation because it's organized much better than what is on the official website.
> > 
> > Example: http://vibed.org/temp/d-programming-language.org/phobos/std/array.html

Hmm. While I really like the layout, because it is so much more readable then the dlang.org version, I wonder how I get information about members of a class, e.g. for RedBlackTree:

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

I only get the creator functions. Funnily the link in functions to redBlackTree leads to a 'page not found'. It also seems that DList has no members?

Best regards,

Robert

Am 21.02.2013 17:02, schrieb Robert:
> On Wed, 2013-02-20 at 23:13 +0100, Sönke Ludwig wrote:
>> Am 20.02.2013 18:45, schrieb Rob T:
>>> I use this experimental sample website regularly for Phobos documentation because it's organized much better than what is on the official website.
>>>
>>> Example: http://vibed.org/temp/d-programming-language.org/phobos/std/array.html
> 
> Hmm. While I really like the layout, because it is so much more readable then the dlang.org version, I wonder how I get information about members of a class, e.g. for RedBlackTree:
> 
> http://vibed.org/temp/d-programming-language.org/phobos/std/container/RedBlackTree.html
> 
> I only get the creator functions. Funnily the link in functions to redBlackTree leads to a 'page not found'. It also seems that DList has no members?
> 
> Best regards,
> 
> Robert
> 

Oh sorry, the problem is that I generated the docs on Windows and the two files differ just by the case of the first character - so one was overwritten by the other. I'll regenerate them on Linux when I have some time.

Am 21.02.2013 18:17, schrieb Sönke Ludwig:
> Am 21.02.2013 17:02, schrieb Robert:
>> On Wed, 2013-02-20 at 23:13 +0100, Sönke Ludwig wrote:
>>> Am 20.02.2013 18:45, schrieb Rob T:
>>>> I use this experimental sample website regularly for Phobos documentation because it's organized much better than what is on the official website.
>>>>
>>>> Example: http://vibed.org/temp/d-programming-language.org/phobos/std/array.html
>>
>> Hmm. While I really like the layout, because it is so much more readable then the dlang.org version, I wonder how I get information about members of a class, e.g. for RedBlackTree:
>>
>> http://vibed.org/temp/d-programming-language.org/phobos/std/container/RedBlackTree.html
>>
>> I only get the creator functions. Funnily the link in functions to redBlackTree leads to a 'page not found'. It also seems that DList has no members?
>>
>> Best regards,
>>
>> Robert
>>
> 
> Oh sorry, the problem is that I generated the docs on Windows and the two files differ just by the case of the first character - so one was overwritten by the other. I'll regenerate them on Linux when I have some time.
> 

Done.

On Fri, 22 Feb 2013 13:17:06 -0500, Sönke Ludwig <sludwig@outerproduct.org> wrote:

> Am 21.02.2013 18:17, schrieb Sönke Ludwig:

>> Oh sorry, the problem is that I generated the docs on Windows and the
>> two files differ just by the case of the first character - so one was
>> overwritten by the other. I'll regenerate them on Linux when I have some
>> time.
>>
>
> Done.

Still doesn't look right.  RedBlackTree is listed as a template, but no methods or fields are listed.

BTW, I really like this format.  I think once these issues are ironed out, it should be moved to Phobos docs.

-Steve

Am Thu, 21 Feb 2013 18:17:26 +0100
schrieb Sönke Ludwig <sludwig@outerproduct.org>:

> Oh sorry, the problem is that I generated the docs on Windows and the two files differ just by the case of the first character - so one was overwritten by the other. I'll regenerate them on Linux when I have some time.

Actually, theoretically, there is a flag for CreateFile that makes it use POSIX semantics and allow two names which only differ in case.

-- 
Marco

Am 23.02.2013 10:33, schrieb Marco Leise:
> Am Thu, 21 Feb 2013 18:17:26 +0100
> schrieb Sönke Ludwig <sludwig@outerproduct.org>:
> 
>> Oh sorry, the problem is that I generated the docs on Windows and the two files differ just by the case of the first character - so one was overwritten by the other. I'll regenerate them on Linux when I have some time.
> 
> Actually, theoretically, there is a flag for CreateFile that makes it use POSIX semantics and allow two names which only differ in case.
> 

Interesting. I've never noticed that flag before. Unfortunately that would only work in the win32 back end (as opposed to the default libevent back end), but maybe that's actually still a viable option, I'll look into it.

Am 22.02.2013 20:34, schrieb Steven Schveighoffer:
> On Fri, 22 Feb 2013 13:17:06 -0500, Sönke Ludwig <sludwig@outerproduct.org> wrote:
> 
>> Am 21.02.2013 18:17, schrieb Sönke Ludwig:
> 
>>> Oh sorry, the problem is that I generated the docs on Windows and the two files differ just by the case of the first character - so one was overwritten by the other. I'll regenerate them on Linux when I have some time.
>>>
>>
>> Done.
> 
> Still doesn't look right.  RedBlackTree is listed as a template, but no methods or fields are listed.
> 
> BTW, I really like this format.  I think once these issues are ironed out, it should be moved to Phobos docs.
> 
> -Steve

Fixed.

I think it would be a good idea to put the new documentation into a kind of half-official place next to the classical docs until they are deemed error-free. That way the exposure would be higher, so that the remaining bugs can be found faster.