The backbone of the ACG Website on GitHub is mostly established, we must now decide what it’s going to look like.
Of concern is that the navigation column gets excessively long when it contains every page, like the large number of Essays in this example (and there are at least 6 more to be added…)
It is possible to have a mix of individual articles and Table-of-Content articles to decrease the clutter, as in Cosmological Models which has approximately 75 articles!
Or, when a large number of items is present, only one page with a table of contents presents every page in the category, such as in Redshift Models with 95 articles. This last possibility requires a bit more work to set up but makes the navigation column cleaner.
I would definitely side with links in the sidebar that leads to a toc page for that section. Note that in Markdown there are tools to generate the toc automagically!
just-the-docsdoes that too, it’s already implemented e.g. for EssaysIt looks really good!