The first D-related hit on searching for

std.algorithm

on Google is https://dlang.org/library/std/algorithm.html. That is the 255th most accessed file on dlang.org (including the .ico, css, .js etc many of which are accessed from most other pages).

Within that page, the top table has links to various constituents such as std.algorithm.searching, std.algorithm.comparison etc. None of those links work.

I recall I reported this a while ago. It either has never been fixed, or it became a problem again. Folks, I can't babysit all this stuff. I can't babysit all this stuff.

This is important and urgent. Who can get on this and stay on this until it's done?

For the future, who can work on a simple tool (or hook us into one of the many existing ones) that detects bad links?


Thanks,

Andrei

On Thursday, 2 June 2016 at 18:24:30 UTC, Andrei Alexandrescu wrote:
> The first D-related hit on searching for
>
> std.algorithm
>
> on Google is https://dlang.org/library/std/algorithm.html. That is the 255th most accessed file on dlang.org (including the .ico, css, .js etc many of which are accessed from most other pages).
>
> Within that page, the top table has links to various constituents such as std.algorithm.searching, std.algorithm.comparison etc. None of those links work.
>
> I recall I reported this a while ago. It either has never been fixed, or it became a problem again. Folks, I can't babysit all this stuff. I can't babysit all this stuff.
>
> This is important and urgent. Who can get on this and stay on this until it's done?
>
> For the future, who can work on a simple tool (or hook us into one of the many existing ones) that detects bad links?
>
>
> Thanks,
>
> Andrei

There seems to some confusion between "phobos" (ddoc) and "library" (ddox).
Both are publicly available.

Afaict the plan is to move over to ddox at some point, because ddoc is way too limited, but (if i am not mistaken) this is blocked by existing bugs in ddoc.

Imho we should only host on documentation on dlang.org and mark the other as experimental by a separate subdomain.

> Within that page, the top table has links to various constituents such as std.algorithm.searching, std.algorithm.comparison etc. None of those links work.

The PR already has been merged, but you have to wait for the next release:

https://github.com/dlang/phobos/pull/4303

On 06/02/2016 02:36 PM, Seb wrote:
> Imho we should only host on documentation on dlang.org and mark the
> other as experimental by a separate subdomain.

We're fine as we are, many documentations offer distinct formats. -- Andrei

On Thursday, 2 June 2016 at 18:24:30 UTC, Andrei Alexandrescu wrote:
> The first D-related hit on searching for
>
> std.algorithm
>
> on Google is https://dlang.org/library/std/algorithm.html. That is the 255th most accessed file on dlang.org (including the .ico, css, .js etc many of which are accessed from most other pages).

/library/ pages are DDOX pages. That is the "NEW Library Reference Preview". It's not ready for prime time. It should be hidden from Google until it's ready. Here's a quick PR to do that: https://github.com/dlang/dlang.org/pull/1320

I guess no one really feels responsible for this stuff.

> I recall I reported this a while ago. It either has never been fixed, or it became a problem again. Folks, I can't babysit all this stuff. I can't babysit all this stuff.

Meh.

On Thursday, 2 June 2016 at 18:24:30 UTC, Andrei Alexandrescu wrote:
> Within that page, the top table has links to various constituents such as std.algorithm.searching, std.algorithm.comparison etc. None of those links work.

I fixed it months ago on my fork
http://dpldocs.info/std.algorithm

(I also removed the "this is a submodule of std.algorithm" since that's a useless sentence anyway, given my autogenerated breadcrumb navigation that makes the submodule relationship clear outside the text)


The continued existence of such bugs is a reason I laugh at the idea that ddox is a serious contender btw.

On 6/2/16 2:44 PM, Adam D. Ruppe wrote:
> (I also removed the "this is a submodule of std.algorithm" since that's
> a useless sentence anyway, given my autogenerated breadcrumb navigation
> that makes the submodule relationship clear outside the text)

http://dpldocs.info/experimental-docs/std.algorithm.html

The breadcrumb for std is missing on that page.

-Steve

Am 02.06.2016 um 20:44 schrieb Adam D. Ruppe:
> On Thursday, 2 June 2016 at 18:24:30 UTC, Andrei Alexandrescu wrote:
>> Within that page, the top table has links to various constituents such
>> as std.algorithm.searching, std.algorithm.comparison etc. None of
>> those links work.
>
> I fixed it months ago on my fork
> http://dpldocs.info/std.algorithm
>
> (I also removed the "this is a submodule of std.algorithm" since that's
> a useless sentence anyway, given my autogenerated breadcrumb navigation
> that makes the submodule relationship clear outside the text)
>
> The continued existence of such bugs is a reason I laugh at the idea
> that ddox is a serious contender btw.

I know you are a hacker by heart and of course you can patch and work around everything. But I'd hate to implement some kind of special case here instead of simply fixing the Phobos sources to use macros that carry proper semantical meaning. Those changes now simply have to get into the latest stable version to appear on the doc pages.

Apart from that, this is really the only major known issue left (links to GitHub for package.d modules are still broken and that's about it).

Am 02.06.2016 um 20:44 schrieb ag0aep6g:
> /library/ pages are DDOX pages. That is the "NEW Library Reference
> Preview". It's not ready for prime time. It should be hidden from Google
> until it's ready. Here's a quick PR to do that:
> https://github.com/dlang/dlang.org/pull/1320
>
> I guess no one really feels responsible for this stuff.

Which are the remaining issues that you know of? I've searched bugzilla earlier today and couldn't find anything apart from broken "Improve this page" links for package.d modules.

On 06/02/2016 02:44 PM, ag0aep6g wrote:
> I guess no one really feels responsible for this stuff.

Vladimir is responsible (I cc'd him with the post and he was quick to reply). He can of course delegate but he's the entry point. All - if you find any issues please report to him. As has become apparent in this thread, Sönke is a great resource as well. Let's keep the band rolling. Thanks! -- Andrei

On Thursday, 2 June 2016 at 19:06:42 UTC, Sönke Ludwig wrote:
> But I'd hate to implement some kind of special case here instead of simply fixing the Phobos sources to use macros that carry proper semantical meaning.

That's actually exactly what I did:

https://github.com/dlang/dlang.org/pull/1177

The foundation even got merged into upstream dlang.org, six months ago!

Sadly, the follow-up, just about two weeks after I laid the foundation* got stalled out <https://github.com/dlang/phobos/pull/3926> until recently, now a PR based on that one <https://github.com/dlang/phobos/pull/4303> got merged ten days ago.

* Cross-linking in ddoc has been remarkably non-trivial until recently, and even so, MREF, REF, and REF_ALTTEXT, while much better than it was before, still aren't ideal.

Fixing links is, in theory, one of the easiest tasks people can do, but in practice the plethora of bizarre macros makes it far harder than it should be. Even the REF macro family, which aims to unify them, has hit hurdles:

https://github.com/dlang/dlang.org/pull/1257