www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - [dlang.org] what to do with remaining orphaned pages

reply "anonymous" <anonymous example.com> writes:
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
Mar 22 2015
next sibling parent reply Rikki Cattermole <alphaglosined gmail.com> writes:
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".
Mar 22 2015
next sibling parent Rikki Cattermole <alphaglosined gmail.com> writes:
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.
Mar 22 2015
prev sibling parent "Marc =?UTF-8?B?U2Now7x0eiI=?= <schuetzm gmx.net> writes:
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.
Mar 22 2015
prev sibling parent Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
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
Mar 22 2015