I was paged about a blog post from an old friend who floats around the circles in the Debian camp.

The author, Matthias, should be no stranger around these forums, though I was surprised to discover that I know him on OFTC too (I wonder if he knows this also).

For those who have been watching the talks at dconf, I think there should be nothing unexpected here.  But each time we hear from the same issues or conclusions being raised, it gives them more weight in the priority queue for what we need solving.

So Matthias, I'd like to give a thanks for your excellent post.  And I hope you don't mind me posting it here.

http://blog.tenstral.net/2016/05/adventures-in-d-programming.html

For everyone else, hope you enjoy the read.

--
Iain

On Sunday, 8 May 2016 at 06:05:36 UTC, Iain Buclaw wrote:
> I was paged about a blog post from an old friend who floats around the circles in the Debian camp.
>
> The author, Matthias, should be no stranger around these forums, though I was surprised to discover that I know him on OFTC too (I wonder if he knows this also).
>
> For those who have been watching the talks at dconf, I think there should be nothing unexpected here.  But each time we hear from the same issues or conclusions being raised, it gives them more weight in the priority queue for what we need solving.
>
> So Matthias, I'd like to give a thanks for your excellent post.
>  And I hope you don't mind me posting it here.
>
> http://blog.tenstral.net/2016/05/adventures-in-d-programming.html
>
> For everyone else, hope you enjoy the read.
>
> --
> Iain

Not only in his blog, even lwn.net mentions it!

Antonio

On Sunday, 8 May 2016 at 06:05:36 UTC, Iain Buclaw wrote:
> http://blog.tenstral.net/2016/05/adventures-in-d-programming.html

Thanks, I missed that post until now.


"the documentation not matching the actual code is a bad experience for someone new to the language"

I would interpret that as a sign that we want multiple versions of documentation available on the website. For example, Python does that.

https://docs.python.org/3.4/contents.html

You see the "3.4" version in the URL and on the page top-left is a dropdown menu to switch between versions.

Has this been discussed for Phobos yet?

Dne 8.5.2016 v 19:19 qznc via Digitalmars-d-announce napsal(a):

> On Sunday, 8 May 2016 at 06:05:36 UTC, Iain Buclaw wrote:
>> http://blog.tenstral.net/2016/05/adventures-in-d-programming.html
>
> Thanks, I missed that post until now.
>
>
> "the documentation not matching the actual code is a bad experience for someone new to the language"
>
> I would interpret that as a sign that we want multiple versions of documentation available on the website. For example, Python does that.
>
> https://docs.python.org/3.4/contents.html
>
> You see the "3.4" version in the URL and on the page top-left is a dropdown menu to switch between versions.
>
> Has this been discussed for Phobos yet?
I remember that I have mentioned that once here, but I thing there was not big interest at it :(

Dne 8.5.2016 v 21:09 Daniel Kozak napsal(a):

> Dne 8.5.2016 v 19:19 qznc via Digitalmars-d-announce napsal(a):
>
>> On Sunday, 8 May 2016 at 06:05:36 UTC, Iain Buclaw wrote:
>>> http://blog.tenstral.net/2016/05/adventures-in-d-programming.html
>>
>> Thanks, I missed that post until now.
>>
>>
>> "the documentation not matching the actual code is a bad experience for someone new to the language"
>>
>> I would interpret that as a sign that we want multiple versions of documentation available on the website. For example, Python does that.
>>
>> https://docs.python.org/3.4/contents.html
>>
>> You see the "3.4" version in the URL and on the page top-left is a dropdown menu to switch between versions.
>>
>> Has this been discussed for Phobos yet?
> I remember that I have mentioned that once here, but I thing there was not big interest at it :(
http://forum.dlang.org/post/srhttrxrqawhspibdlrj@forum.dlang.org

On Sunday, 8 May 2016 at 19:09:07 UTC, Daniel Kozak wrote:
> I remember that I have mentioned that once here, but I thing there was not big interest at it :(

I'm doing it on dpldocs.info as soon as I leave the alpha period (which is finally coming soon).

Dne 8.5.2016 v 21:12 Adam D. Ruppe via Digitalmars-d-announce napsal(a):

> On Sunday, 8 May 2016 at 19:09:07 UTC, Daniel Kozak wrote:
>> I remember that I have mentioned that once here, but I thing there was not big interest at it :(
>
> I'm doing it on dpldocs.info as soon as I leave the alpha period (which is finally coming soon).

You are awesome :)

On 5/8/16 8:19 PM, qznc wrote:
> On Sunday, 8 May 2016 at 06:05:36 UTC, Iain Buclaw wrote:
>> http://blog.tenstral.net/2016/05/adventures-in-d-programming.html
>
> Thanks, I missed that post until now.
>
>
> "the documentation not matching the actual code is a bad experience for
> someone new to the language"
>
> I would interpret that as a sign that we want multiple versions of
> documentation available on the website. For example, Python does that.
>
> https://docs.python.org/3.4/contents.html
>
> You see the "3.4" version in the URL and on the page top-left is a
> dropdown menu to switch between versions.
>
> Has this been discussed for Phobos yet?

No, but it's been on my mind for a while. -- Andrei

On Sunday, 8 May 2016 at 19:12:17 UTC, Adam D. Ruppe wrote:
> On Sunday, 8 May 2016 at 19:09:07 UTC, Daniel Kozak wrote:
>> I remember that I have mentioned that once here, but I thing there was not big interest at it :(
>
> I'm doing it on dpldocs.info as soon as I leave the alpha period (which is finally coming soon).

I haven't logged on for a look in ages.
Have done so now, and they've come on leaps and bounds.

Really like the layout and styling of the different pages.
Jolly good show!

On Sunday, 8 May 2016 at 17:19:05 UTC, qznc wrote:
> On Sunday, 8 May 2016 at 06:05:36 UTC, Iain Buclaw wrote:
>> http://blog.tenstral.net/2016/05/adventures-in-d-programming.html
>
> Thanks, I missed that post until now.
>
>
> "the documentation not matching the actual code is a bad experience for someone new to the language"
>
> I would interpret that as a sign that we want multiple versions of documentation available on the website. For example, Python does that.

You've quoted the wrong part of the paragraph. The real problem he encountered was not the doc, it was the phobos bugs in the older version shipped with GDC/LDC:

"For GDC, which I used to compile my code due to LDC having bugs at that time, this means that it is shipping with a very outdated copy of Phobos"

The the doc thing is "just" a symptom. Older offline doc is always available in the release archive, it's easy to understand that so it's not the actual problem.