Documentation icon indicating copy to clipboard operation
Documentation copied to clipboard

Don't hide the left sidebar at 76em

Open lapcat opened this issue 2 years ago • 3 comments

The left sidebar is hidden at around 76em. This is a relatively large window width even on desktop. Compare my two screenshots.

Screen Shot 2023-05-05 at 1 58 15 PM

Screen Shot 2023-05-05 at 1 58 24 PM

lapcat avatar May 05 '23 19:05 lapcat

Thanks, I'll need to take look into this. I agree it is a bit over eager with hiding the side bar at large screen sizes.

stwrt avatar May 05 '23 22:05 stwrt

So I spent some time looking over this. This behavior is coming from the framework and I would need to do some investigation about modifying this, and I am not completely sure what we would want to set it to at the moment if we did modify it.

Just for some context though other major documentation frameworks I looked at start to exhibit similar collapsing behavior between 1000-1280 pixels. MkDocs Material starts collapsing the side bar at 1220 pixels. This is a little on the higher side, but not abnormal.

Framework px Collapse Sidebar
Docusaurus ~1000px
Apple Developer Docs ~1000px
React Docs ~1024px
MkDocs Material 1220 px
Nextra 1280px
GitHub Docs 1280px

Numbers not super scientific just looked at the px count in WebInspector

stwrt avatar May 17 '23 05:05 stwrt

Perhaps the problem is really the dueling document outlines on the left and right sides, which is also kind of confusing.

The Apple developer docs only have an outline on the left side, and even when the outline is collapsed, the widget in the upper left corner can open it.

Screen Shot 2023-05-17 at 6 18 36 AM Screen Shot 2023-05-17 at 6 19 00 AM Screen Shot 2023-05-17 at 6 19 06 AM

lapcat avatar May 17 '23 11:05 lapcat