Skip to content

Conversation

thisisjofrank
Copy link
Collaborator

@thisisjofrank thisisjofrank commented Aug 5, 2025

The API reference sidebar feels ugly and clunky, I've moved it over to the left hand sidebar and grouped the three "sections" under one menu

I have also moved each of the 'api landing pages' that are currently in runtime/reference/ into the api reference section, so, for example
https://docs.deno.com/runtime/reference/deno_namespace_apis/ becomes https://docs.deno.com/api/deno/

I've also made the accordions collapse when a different accordion is expanded and now the sidebar will scroll to the correct position when a page is loaded to show the 'active' link in the browser viewport.

Old:
image

New:
image

@philhawksworth
Copy link
Member

I really like this as a visual update. It feels like it adopts and stenghtens the conventions about showing hierarchy around the docs site

It also lends itself well to having an intro explanatory page for each section which is present in the sidebar nav too.

@thisisjofrank thisisjofrank marked this pull request as ready for review September 3, 2025 15:43
@philhawksworth
Copy link
Member

This feels SO much cleaner and more logical.

Q: Should the sidebar highlight the active section for All [Deno|Node|Web] Symbols as it does with other sections and in prod?

(It doesn't currently, and feels like it should if possible. (See https://deno-docs-4f1c2gr361t7.deno.dev/api/deno/all_symbols)

Copy link
Member

@philhawksworth philhawksworth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great!

@thisisjofrank thisisjofrank merged commit 7a0c03b into main Sep 4, 2025
4 of 5 checks passed
@thisisjofrank thisisjofrank deleted the ref_secondary_to_sidebar branch September 4, 2025 10:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants