urbit / urbit.org

The source for urbit.org
https://urbit.org
MIT License
93 stars 197 forks source link

glossary no longer has a table of contents #1128

Open drbeefsupreme opened 3 years ago

drbeefsupreme commented 3 years ago

This page https://urbit.org/docs/glossary used to have an automatically generated and categorized list of all of the glossary entries, allowing people to understand roughly how various concepts are grouped together, i.e. "Arvo", "Azimuth", "Hoon". It seems to have vanished, I'm guessing with the transition away from zola.

matildepark commented 2 years ago

Ah you're right, shit, we can rewrite this easily though.

matildepark commented 2 years ago

Status on this is: while easy to implement if we hardcode a template for the Glossary page, we need to get out of that pattern. It's already not maintainable and it'll get worse quite soon. Ideally we use Markdoc, introduce a Glossary component, and have that component iterate through glossary entries according to their categories. Then we don't introduce another page template, we just do it in the .md file as a Markdoc component. See #1299