Agoric / documentation

User documentation
https://agoric.com/documentation/
Apache License 2.0
15 stars 38 forks source link

Docs Revamp - Organizing the Navigation #973

Closed sufyaankhan closed 3 months ago

sufyaankhan commented 5 months ago

Goal: To organize the Nav bar for the entire Docs site.

dckc commented 4 months ago

some prototyping: https://github.com/kbennett2000/agoric-slides

image

dckc commented 3 months ago

Demote out-of-date pages from navigation

The Wallet and Wallet UI pages are outdated. I suggest omitting them from nav.js / config.mjs.

(For folks that do manage to find them, the pages should probably have a beta notice as in #837, #904 . Is that in scope for this issue?)

Likewise the following pages that are currently in either the left or the top nav bar:

originally in https://github.com/Agoric/documentation/pull/989#issuecomment-2002872045

dckc commented 3 months ago

@sufyaankhan @kbennett2000 TIL that we have multiple sidebars (as of the vitepress transition?) So navigation updates should keep that in mind.

There's more detail in https://github.com/Agoric/documentation/issues/1005#issuecomment-2007209666 and following , where @0xpatrickdev writes:

As part of #973, I think it would be nice keep multiple sidebars. ...