canonical / canonical/vanilla-framework

Document orphan best practice and recommend manual solutions

Open
#4,832 5 comments 0 reactions 0 assignees View on GitHub
P3 Triaged Triaged: Pragma
Dominant language
HTML
Stars
983
Forks
216
Avg merge
3d 13h
Merged PRs (30d)
3

Description

It would be good to document that orphans (single words wrapping) is undesirable, and can be avoided by inserting ` `s between the last few words of a heading/anypiece of text.

Related issue: https://warthogs.atlassian.net/browse/WD-5132

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the documentation structure and the related WD-5132 issue to identify where guidance on orphaned words belongs. Document why single-word wraps are undesirable and describe using non-breaking spaces between the last few words of headings or other text as a manual solution. Done means the recommendation is present in the project's documentation and links or references the related issue where appropriate.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.