Cool Stuff for D that we keep Secret
w0rp via Digitalmars-d
digitalmars-d at puremagic.com
Tue Jul 15 15:04:12 PDT 2014
On Monday, 14 July 2014 at 15:45:39 UTC, David Gileadi wrote:
> On 7/14/14, 5:03 AM, w0rp wrote:
>>> Then I wondered if the "Documentation" section should be
>>> renamed "Language Specifications" and the links renamed to
>>> "DMD 1" and "DMD 2" or if they should be merged into the
>>> sections for DMD 1 and DMD 2 respectively, because 7 year old
>>> DMD 1 specs are now pretty much obsolete? Someone new to the
>>> web site looking for (current) compiler documentation will
>>> only get confused.
>>
>> That's a good shout. I like the "Language Specifications"
>> suggestion. I'll make a note to change that later.
>
> When I first reorganized the current site I ended up using
> "Language Reference" and "Library Reference" for the D-spec and
> Phobos docs, respectively. There was also a collection of
> articles which fell under documentation, for lack of a better
> place to put them, and the Documentation section has grown
> since.
>
> I don't know where the documentation link should take you, but
> there are a number of sections under the current Documentation
> (including not one, not two but three "tutorial" links, each
> named slightly differently and all of which leave dlang.org). I
> personally think that "Language Specification" is a bit narrow
> to cover all those topics.
He was actually referring to the subsection in the Downloads
page. I made that same mistake myself until I read what he said a
couple of times more and then I got what he was saying. Still I
understand what you're saying about what should go in there. For
the moment on the master branch it takes you right to the library
documentation.
More information about the Digitalmars-d
mailing list