• tipdbmp (7/7) Dec 29 2017 It seems to me that some of the language reference/spec pages
• Mike Franklin (8/15) Dec 29 2017 If you have a suggestion for improving the documentation, please
• Seb (7/22) Dec 29 2017 Yes, opening an issue or PR is the best way to move things
• Seb (3/12) Jan 02 2018 TOC generation is there ->

tipdbmp <email example.com> writes:

It seems to me that some of the language reference/spec pages 
that are somewhat long,
could provide a Toc (Table of contents) which should help users 
see an overview of what's
there and improve the searchability and the navigation of the 
content.
The 'Functions' page has a Toc already.

Mike Franklin <slavo5150 yahoo.com> writes:

On Friday, 29 December 2017 at 12:06:12 UTC, tipdbmp wrote:
 It seems to me that some of the language reference/spec pages 
 that are somewhat long,
 could provide a Toc (Table of contents) which should help users 
 see an overview of what's
 there and improve the searchability and the navigation of the 
 content.
 The 'Functions' page has a Toc already.

If you have a suggestion for improving the documentation, please 
file an issue at https://issues.dlang.org/  Occasionally 
contributors go fishing for easy issues like that in the issues 
list and will submit pull requests.

Even better, you may want to file a pull request yourself at 
https://github.com/dlang/dlang.org

Mike

Seb <seb wilzba.ch> writes:

On Friday, 29 December 2017 at 12:13:02 UTC, Mike Franklin wrote:
 On Friday, 29 December 2017 at 12:06:12 UTC, tipdbmp wrote:
 It seems to me that some of the language reference/spec pages 
 that are somewhat long,
 could provide a Toc (Table of contents) which should help 
 users see an overview of what's
 there and improve the searchability and the navigation of the 
 content.
 The 'Functions' page has a Toc already.

 If you have a suggestion for improving the documentation, 
 please file an issue at https://issues.dlang.org/  Occasionally 
 contributors go fishing for easy issues like that in the issues 
 list and will submit pull requests.

 Even better, you may want to file a pull request yourself at 
 https://github.com/dlang/dlang.org

 Mike

Yes, opening an issue or PR is the best way to move things 
forward.
In this case, this is already on my radar and will happen soon 
(since a couple of weeks we already got a footer pagination). 
It's pretty ugly because Ddoc is used for dlang.org which makes 
trivial stuff like this rather complicated :/

Seb <seb wilzba.ch> writes:

On Friday, 29 December 2017 at 12:17:47 UTC, Seb wrote:
 On Friday, 29 December 2017 at 12:13:02 UTC, Mike Franklin 
 wrote:
 [...]

 Yes, opening an issue or PR is the best way to move things 
 forward.
 In this case, this is already on my radar and will happen soon 
 (since a couple of weeks we already got a footer pagination). 
 It's pretty ugly because Ddoc is used for dlang.org which makes 
 trivial stuff like this rather complicated :/

TOC generation is there -> 
https://github.com/dlang/dlang.org/pull/2043