typedb/typedb-docs

Long Doc pages with list of contents are hard to navigate.

Closed this issue · 1 comments

Problem to Solve

On some of the longer pages of the docs:
https://docs.vaticle.com/docs/examples/phone-calls-migration-nodejs, https://docs.vaticle.com/docs/schema/concepts for example. They get hard to navigate when I am jumping around putting concepts together in my own learning path.

image

Proposed Solution

It would be helpful if either the navigation at the top of the page was made readily available anywhere on the page, or if there was a scroll to top button that shows up. I forget what topics are on a different section of the same page verses going to try to find them on a different doc page.

Hi @amaster507 - absolutely agree, the navigation needs significant improvement. The plan is to entirely overhaul the docs with a new structure, and therefore new navigation. Rather than fix issues in the current state we prefer to make the switch and move on in the coming weeks/months. Navigation will certainly be considered so I can safely close this issue for now.