Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing sidebar TOC on large screens #84

Open
Wryhder opened this issue May 11, 2024 · 6 comments
Open

Missing sidebar TOC on large screens #84

Wryhder opened this issue May 11, 2024 · 6 comments

Comments

@Wryhder
Copy link

Wryhder commented May 11, 2024

It feels a bit awkward to constantly click the hamburger icon to navigate the doc site on a PC. I'd like to suggest adding a sidebar table of contents (TOC) for large screens and only introducing the hamburger menu on smaller screens. Having a prominent TOC on large screens should also help (re-)orient a user regarding their current place in the docs without needing to click the icon.

missing sidebar toc on large screens-fundamentals-asterisk  architecture

@Wryhder
Copy link
Author

Wryhder commented May 11, 2024

I'd love to create a PR for this if accepted as a valid issue.

@gtjoseph
Copy link
Member

Welcome! The left side navigation bar should automatically show when the browser window is wide enough to display it which seems to be about 1500 pixels. What size screen do you have and what happens if you maximize your browser?

@Wryhder
Copy link
Author

Wryhder commented May 13, 2024

Welcome! The left side navigation bar should automatically show when the browser window is wide enough to display it which seems to be about 1500 pixels. What size screen do you have and what happens if you maximize your browser?

Ah, my bad. I didn't realize there was a sidebar.

My browser is always maxed. I'm not sure if these are the relevant details you're asking for. This is from my browser console:

> window.screen.width
1172
> window.innerWidth
1164

My PC is a 14-inch (1920 x 1080 display), which is relatively small, but it's usually large enough to fit most website's content and TOCs. Could the 1500 be adjusted to accommodate smaller sizes than this number?

@gtjoseph
Copy link
Member

Interesting. If you're browser is maximized on a 1920x1080 display, then window.screen.width should be 1920. The TOC innerWidth cutoff looks to be about 1220 but let me see if I can control that.

@Wryhder
Copy link
Author

Wryhder commented May 13, 2024

Interesting. If you're browser is maximized on a 1920x1080 display, then window.screen.width should be 1920.

This made me curious so I checked and I was using 150% scaling. Changing it to 100% gave me these values in the console:

> window.screen.width
1751
> window.innerWidth
1746

The sidebar also showed up for me on the doc site. However, at this scale icons and text on my screen are too small for comfort, so I'm back to 150.

The TOC innerWidth cutoff looks to be about 1220 but let me see if I can control that.

I'd appreciate it if you make the change, but please free to close the issue (as it seems less valid than I thought when I opened it).

@gtjoseph
Copy link
Member

Gotcha. I'm still looking. Maybe there's also a buried option somewhere to allow the user to always show the sidebar.

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

No branches or pull requests

2 participants