site: improve page organization / add a browseable sitemap

Split from

• do we want a browseable site map?

:

I was thinking that we could have One page which was both the site map +
gave us control over which things were parents of which other things and
what the order of the children was. We can ensure with a test that the List
is complete. And that makes it really easy to move pages around: change
parents, change order, etc

A generated (browseable) site map would let us see what the page hierarchy is.

I’m concerned that a manually edited single page that lists all pages would make it painful to update the site.

Step 3:

• Add some data so that we can control the sitemap structure: that is, the children of each parent, and exactly what their order should be when listed.

  • Why? The folder structure is in many cases very weird and accidental. (the fake /index/ level, etc.) Yet we don’t want to change the ULS to get to pages, because that would invalidate old links. Moreover, we must to be able to control the order of the children of a given parent anyway.

  • We’d have to explore how we encapsulate this data. Could just be an index .md file with different levels of bullets. That would be easy to see the overall structure, and have a test that it contains all the .md files. It could also serve as a global sitemap.

Step 4

Consider designs for a UI to show sibling pages

1. Some thoughts on these are in