Multiple stakeholders in the Quarkus community have given feedback that the navigation and findability experience in the Quarkus upstream docs portal site has some gaps and needs to be enhanced.

The new diataxis-styled landing page is greatly improved and provided good navigation and filtering options by content type and by technical topic.

However...

Problems:

• When you open a page, you lose a sense of where you are and what other related information is available in this category.
• There are too many single pages at the top level, which means a lot of content on the main index/splash pages with very basic filtering.
• The current architecture of the portal relies on individual links to the other topics in the docs portal. This is a manual effort that needs maintenance.
• The Quarkus user has to find those links or use the back button to get back to the top-level landing page. This is poor IA.

Scope of this JIRA:

To work with the upstream key stakeholders to implement a taxonomy and navigation structure (TOC, breadcrumb trail, and/or other ) that is dynamic and complements the main doc index page. The IA could also be leveraged by the downstream doc single-sourcing effort.