dgraph-io / dgraph-docs

A native GraphQL Database with a graph backend
https://dgraph.io/docs
Other
35 stars 66 forks source link

Sidebars take up too much space on vertical displays. #658

Open maringuu opened 6 months ago

maringuu commented 6 months ago

The Problem

All screenshots were taken on a 3840x2160 display in Firefox zoomet to 130%.

Lets first have a look at the docs on a regular horizontal display. Looks good and nicely readable.

Dgraph - horizontal ![dgraph-horizontal](https://github.com/dgraph-io/dgraph-docs/assets/60553448/dcae09d7-288d-4bf1-9bae-148619092d43)

On the other hand the vertical version is very ugly and hard to read. The actual documentation take up only one third of the available screenspace.

Dgraph - vertical ![dgraph-vertical](https://github.com/dgraph-io/dgraph-docs/assets/60553448/67576c7a-2d56-49e6-ab02-28da93c4e9b4)

As a comparison here is a screenshot of the Rust Book. It is way more readable.

Rust - vertical ![rust-vertical](https://github.com/dgraph-io/dgraph-docs/assets/60553448/03b25800-59d9-4f0b-af51-a27773154966)

Possible solutions

If both sidebars ("On This Page" and the left one) could be hidden manually, the actual documentation could take up all screenspace. Interestingly the left sidebar automatically hides in the following screenshot.

Dgraph - hidden sidebar ![dgraph-half](https://github.com/dgraph-io/dgraph-docs/assets/60553448/d6844fcc-5644-41c3-9430-4b2ce2c43e85)

Edit: Related https://github.com/dgraph-io/dgraph-docs/issues/623

github-actions[bot] commented 1 month ago

This issue has been stale for 60 days and will be closed automatically in 7 days. Comment to keep it open.