We recently recovered a bunch of pages that were removed from the menu accidentally [1]. Two pages are still orphaned and I'm not sure what to do about them:


http://dlang.org/overview.html

This was not part of some $(SUBNAV_*), so removal may have been deliberate. But there's no mention of it in the commit [2], so I'm assuming this was an accident, too.

I guess this fits best under Books & Articles. But "Overview" is a bad title then. Suggestions?


http://dlang.org/spec.html

This is the "Table of Contents" of the language reference. It's mostly links to the other pages of the reference. We don't need it in the menu for that.

But it also has links to the PDF, Mobi, and Kindle versions of the language reference. We need those somewhere. Where to put them?


[1] https://issues.dlang.org/show_bug.cgi?id=14280
[2] https://github.com/D-Programming-Language/dlang.org/commit/e486d39bd071fa00371bc01d55cd9815ee2210b4

On 22/03/2015 11:54 p.m., anonymous wrote:
> We recently recovered a bunch of pages that were removed from the menu
> accidentally [1]. Two pages are still orphaned and I'm not sure what to
> do about them:
>
>
> http://dlang.org/overview.html
>
> This was not part of some $(SUBNAV_*), so removal may have been
> deliberate. But there's no mention of it in the commit [2], so I'm
> assuming this was an accident, too.
>
> I guess this fits best under Books & Articles. But "Overview" is a bad
> title then. Suggestions?
>
>
> http://dlang.org/spec.html
>
> This is the "Table of Contents" of the language reference. It's mostly
> links to the other pages of the reference. We don't need it in the menu
> for that.
>
> But it also has links to the PDF, Mobi, and Kindle versions of the
> language reference. We need those somewhere. Where to put them?
>
>
> [1] https://issues.dlang.org/show_bug.cgi?id=14280
> [2]
> https://github.com/D-Programming-Language/dlang.org/commit/e486d39bd071fa00371bc01d55cd9815ee2210b4

Based upon what I'm seeing in overview, it might need to be updated BUT, the idea behind the page would be perfect for e.g. background or "purpose".

On 23/03/2015 12:08 a.m., Rikki Cattermole wrote:
> On 22/03/2015 11:54 p.m., anonymous wrote:
>> We recently recovered a bunch of pages that were removed from the menu
>> accidentally [1]. Two pages are still orphaned and I'm not sure what to
>> do about them:
>>
>>
>> http://dlang.org/overview.html
>>
>> This was not part of some $(SUBNAV_*), so removal may have been
>> deliberate. But there's no mention of it in the commit [2], so I'm
>> assuming this was an accident, too.
>>
>> I guess this fits best under Books & Articles. But "Overview" is a bad
>> title then. Suggestions?
>>
>>
>> http://dlang.org/spec.html
>>
>> This is the "Table of Contents" of the language reference. It's mostly
>> links to the other pages of the reference. We don't need it in the menu
>> for that.
>>
>> But it also has links to the PDF, Mobi, and Kindle versions of the
>> language reference. We need those somewhere. Where to put them?
>>
>>
>> [1] https://issues.dlang.org/show_bug.cgi?id=14280
>> [2]
>> https://github.com/D-Programming-Language/dlang.org/commit/e486d39bd071fa00371bc01d55cd9815ee2210b4
>>
>
> Based upon what I'm seeing in overview, it might need to be updated BUT,
> the idea behind the page would be perfect for e.g. background or "purpose".

With regards to spec, kill it. Kill it with fire. Unless it actually has some purpose in the generation of the site? In which case, make should auto delete it from the generated directory.
Links to e.g. mobi/pdf should be on the downloads page.

On Sunday, 22 March 2015 at 11:08:49 UTC, Rikki Cattermole wrote:
> On 22/03/2015 11:54 p.m., anonymous wrote:
>> We recently recovered a bunch of pages that were removed from the menu
>> accidentally [1]. Two pages are still orphaned and I'm not sure what to
>> do about them:
>>
>>
>> http://dlang.org/overview.html
>>
>> This was not part of some $(SUBNAV_*), so removal may have been
>> deliberate. But there's no mention of it in the commit [2], so I'm
>> assuming this was an accident, too.
>>
>> I guess this fits best under Books & Articles. But "Overview" is a bad
>> title then. Suggestions?
>>
>>
>> http://dlang.org/spec.html
>>
>> This is the "Table of Contents" of the language reference. It's mostly
>> links to the other pages of the reference. We don't need it in the menu
>> for that.
>>
>> But it also has links to the PDF, Mobi, and Kindle versions of the
>> language reference. We need those somewhere. Where to put them?
>>
>>
>> [1] https://issues.dlang.org/show_bug.cgi?id=14280
>> [2]
>> https://github.com/D-Programming-Language/dlang.org/commit/e486d39bd071fa00371bc01d55cd9815ee2210b4
>
> Based upon what I'm seeing in overview, it might need to be updated BUT, the idea behind the page would be perfect for e.g. background or "purpose".

+1

This could be the next page (after the start page) that a new visitor to dlang.org can read to get a more in-depth description of the language.

On 3/22/15 3:54 AM, anonymous wrote:
> We recently recovered a bunch of pages that were removed from the menu
> accidentally [1]. Two pages are still orphaned and I'm not sure what to
> do about them:
>
>
> http://dlang.org/overview.html

That must go.

> This was not part of some $(SUBNAV_*), so removal may have been
> deliberate. But there's no mention of it in the commit [2], so I'm
> assuming this was an accident, too.
>
> I guess this fits best under Books & Articles. But "Overview" is a bad
> title then. Suggestions?
>
>
> http://dlang.org/spec.html
>
> This is the "Table of Contents" of the language reference. It's mostly
> links to the other pages of the reference. We don't need it in the menu
> for that.
>
> But it also has links to the PDF, Mobi, and Kindle versions of the
> language reference. We need those somewhere. Where to put them?

Those would be useful. The TOC is practically the left-hand-side menu so it's redundant. -- Andrei