Handle long lines in manual with line wrapping
Table of Contents
This page is a capture in the inbox bucket of the product backlog — a pre-sprint idea, not yet pulled into a sprint as a story.
What
Add line-wrapping support to the manual so that long lines — command
examples, file paths, log output — do not overflow their container.
Preferred approach: apply overflow-wrap: break-word on pre / code
blocks in assets/style.css as the baseline; use a horizontal
scroll-box only for content where wrapping would harm readability (e.g.
one-liner commands where a mid-word break is worse than scrolling). The
fix should cover at least the common cases surfaced in the shell
provisioning chapter.
Why
Long unbroken lines currently overflow the page layout on narrow viewports and make copy-pasting unreliable. This is particularly visible in chapters with shell commands and file paths.
References
- Related chapter:
doc/manual/provisioning_from_the_shell/ - Stylesheet:
assets/style.css