rust-gamedev / rust-gamedev.github.io

The repository for https://gamedev.rs
https://gamedev.rs
Apache License 2.0
395 stars 344 forks source link

Add table of contents #38

Closed remram44 closed 4 years ago

remram44 commented 5 years ago

The articles are getting long and are organized in multiple sections. It is probably worth having a table of contents at the top or on the side. Example for this week:

ozkriff commented 4 years ago

Hmm, I don't think that ToC would improve the newsletter.

The newsletter has a pretty flat structure, so (as demonstrated in the PRs screenshots) we can't really show the full headers hierarchy, because it's just too big and can take more than a screen (especially on mobile devices). Alternative ToC that is limited to h2 headers just doesn't provide much useful information.

17cupsofcoffee commented 4 years ago

@ozkriff I will take no offense if my PR gets rejected, just wanted to provide an example of what it might look like :) Agree that it doesn't provide a ton of value if we can't show the the individual sections.

I'd like to extract the anchor links bit out into a separate PR though, as that seems more useful.