Increase readability by decreasing content width
When reading GitLab docs it's a bit harder to read the text than on other documentation pages like:
| Docs | 1080p | 4K | Positioning |
|---|---|---|---|
| React | ![]() |
![]() |
Content aligned center, right navbar aligned right. |
| Vue | ![]() |
![]() |
Content aligned center, left navbar aligned left. |
| Docker | ![]() |
![]() |
Content and left navbar aligned left, right navbar aligned right. |
| Datadog | ![]() |
![]() |
Content and navbars stay the same, aligned in the center. |
| Heroku | ![]() |
![]() |
Content and navbars stay the same, aligned in the center. |
I think this is mostly because of the width of the content. Usability wise, the optimal line length is somewhere between 50-75 characters and with the current design that spans over the whole page it's harder to focus on the text.
I am well aware that some users might not have browsers set to full width on a 27inch screen but we should also care about these cases.
Here is how it looks like with a before and after if the maximum width of the content would decrease:
| Before | After |
|---|---|
![]() |
![]() |
I'd like to hear what you think :)
Edited by Nicolas Dular











