On Monday, 1 October 2012 at 19:39:35 UTC, Piotr Szturmaj wrote:
> Mr. Anonymous wrote:
>> OK, I looked at it, and I saw that the links are generated by javascript.
>> So I decided to try and write a better javascript function for creating
>> links.
>>
>> Here's what I came up with:
>> The JS code: http://pastebin.com/Pz4fb4JR
>> Screenshots: http://i.imgur.com/gwxrI.png, http://i.imgur.com/qGGQn.png
>>
>> As you can see, the code works for both the website html and the one
>> bundled with dmd.
>> If my function finds nothing, it falls back to it's old version of
>> anchor list.
>>
>> This solution is quite bad and temporary, but what we have now is not
>> much better, so, for a while, I think it's worth using.
>
> I've also tried to improve it:
> http://forum.dlang.org/thread/jb0ril$17oa$1@digitalmars.com
>
> But I think that top positioned index is bad. It should be on the left, or the right pane.

Why hasn't it been integrated?
I guess the reason is that everybody says "that's not a solution, we have to fix x and y", but nobody actually fixes that stuff, and the reality is that we're left with an unusable list of anchored SEO-spam links for years.
That's why I did the change as simple as possible - it should take no more than a minute to replace the function.

P.S. can somebody create a pull request for this at github? I'm not familiar with this stuff.

On Saturday, 29 September 2012 at 16:34:41 UTC, Andrei Alexandrescu wrote:
> On 9/29/12 11:30 AM, Mr. Anonymous wrote:
>> I think documentation is really important, and something has to be done
>> about it. How can a newcomer get started with D when he doesn't have a
>> readable documentation of Phobos?
>
> Agree. It's high time we replace the silly litany of names at the top with a more sensible index (or, indeed, nothing at all!)
>
> Andrei

That sounds great. I'm an experience developer new to D and i find the documentation quite frustrating to navigate and use. Things are kind of all over the place at the minute.

http://forum.dlang.org/thread/k4f4tp$8p4$1@digitalmars.com#post-k4fdsc:24v9u:241:40digitalmars.com

vibe.d got clickable types in documentation, perhaps this could be somehow integrated into phobos docs?

Reviving old topic.

I've been recently checking few general dlang.org pages like http://dlang.org/cpptod.html and noticed that there is plenty of stuff that is either deprecated ( like typedef ) or not really advised ( like C-style function type declarations ). Probably all language docs need a good pass-through to cleanup all possible misunderstandings. It is especially important for newbie-oriented pages like cpptod.html

I'd gladly do it but it feels like someones pretty experienced time is required to actually validate stuff :(

On Friday, 5 October 2012 at 15:38:13 UTC, mist wrote:
> I'd gladly do it but it feels like someones pretty experienced time is required to actually validate stuff :(

That is where the pull request is great. The hard work of finding and making the change can be done by the many, and review can be done by the authorities (and sometimes more knowledgeable).