dlang.org redesign -- the state of documentation and learning resources [part 2]

[H. S. Teoh via Digitalmars-d]

On Mon, Jan 26, 2015 at 09:48:34AM -0700, David Gileadi via Digitalmars-d wrote:
> On 1/25/15 4:42 AM, Andrej Mitrovic via Digitalmars-d wrote:
> >Here's another one:
> >
> >The search box allows selecting between:
> >- Entire D Site
> >- Library reference
> >- Newsgroup archives
> >
> >But where's the Language spec option?
> 
> It's missing due to how dlang.org is set up, and the limitations of
> Google's site search feature. If you click on a link in the language
> spec, like on Types, you'll notice that its URL has the page directly
> under dlang.org, e.g. http://dlang.org/type.html.
> 
> In contrast, the standard library is in a subfolder (e.g.
> http://dlang.org/phobos/std_algorithm.html) and the newsgroup archives
> are in another subfolder. Being in a subfolder allows us to pass a
> prefix parameter to Google's site search that will limit its results
> to URLS with that prefix. Since the language reference isn't in a
> subfolder there's no prefix for the language reference that doesn't
> also include everything else in the site, and hence there's no option
> for Language Spec.
> 
> I don't know how hard it would be to put all the language spec pages
> into their own subfolder, but doing so would allow us to add the
> Language Spec option to the dropdown.

It shouldn't be too hard. Except it will require some HTTP redirects so
that existing incoming links won't unduly break. There has already been
PRs for reorganizing the files at the top level of the dlang.org repo.


T

-- 
Knowledge is that area of ignorance that we arrange and classify. -- Ambrose Bierce