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.

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

On Saturday, 24 January 2015 at 18:59:52 UTC, H. S. Teoh wrote:
> On Sat, Jan 24, 2015 at 06:51:08PM +0000, Zach the Mystic via Digitalmars-d wrote:
>> On Friday, 23 January 2015 at 21:56:59 UTC, H. S. Teoh wrote:
>> >On Fri, Jan 23, 2015 at 09:20:10PM +0000, Zach the Mystic via
>> >Digitalmars-d wrote:
>> >[...]
>> >>I have a basic suggestion on how to get started. Create a "Learning
>> >>D" button and put it on the menu at left on the front page. On the
>> >>page it links to, start by researching and listing every existing
>> >>resource for learning D, in a "kitchen sink" kind of way. Now future
>> >>contributors can know what already exists, and what doesn't. The
>> >>importance of this list is that anyone wanting to help create new
>> >>teaching aids can quickly get up to speed on the current state of
>> >>affairs. They can feel assured that they're not duplicating anyone
>> >>else's work. As the official list and accessible from the front
>> >>page, it's more likely to be kept up to date. The point is that it
>> >>serves double duty both as a treasure trove of learning links, and
>> >>as a complete reference for future contributors. Destroy, please!
>> >
>> >Let's see the PR! ;-)
>> >
>> >
>> >T
>> 
>> Consider me destroyed! I mean to get started with it, but it'll take a
>> week or so.
>
> A week is a short time as far as D pull requests go. :-P
>
> Also, incremental is the key. Don't bite off more than you can chew.
> Start with a barebones skeletal version of what you envision. Make it
> work, then submit the PR. Let others build upon it.
>
>
> T

Here it is, T:

https://github.com/D-Programming-Language/dlang.org/pull/878

https://issues.dlang.org/show_bug.cgi?id=14088

I think we should make the Wiki the first place beginners should go. It's quite a step ahead of the dlang.org website. We should transfer all the articles on dlang to the Wiki, IMO.

Just look at how clunky and old some of dlang is compared to the Wiki. There seems to be a huge rift between the advantages of using DDoc to keep code documentation up to date, and the advantages of the easily and instantly edited Wiki. Looking at the two sites, the Wiki is the clear winner for anything except the language and library reference... and it could eventually be the winner even on those, with enough people editing without the burden of code review or Ddoc's learning curve.

On Friday, 23 January 2015 at 18:37:07 UTC, Martin Drašar wrote:
> Dne 23.1.2015 v 19:16 Andrei Alexandrescu via Digitalmars-d napsal(a):
>> Both are nice:
>> 
>> http://tour.golang.org/welcome/1
>> http://rustbyexample.com/
>
> Or something along the lines of https://tryhaskell.org
> With possible integration with D REPL.

That's actually where I want to go with D REPL.
Even more interesting would be user editable tutorials.
As usual lacking the time for this right now.