Where each limit comes from¶
The source of each limit in the rules for a page. The rule numbers are those of What a page contains, section 5. The guides behind the other rules are on References on writing documentation.
Rule is the rule’s number, Limit what it allows, and Source the guide that gives the figure.
Rule |
Limit |
Source |
|---|---|---|
5.1 |
a title of 65 characters |
|
5.2 |
a sentence of 25 words |
|
5.3 |
a paragraph of 3 to 5 sentences |
Google technical writing: paragraphs (three to five); GOV.UK: use clear language (five at most) |
5.4 |
a list of 2 to 7 items |
|
5.5 |
2 callouts |
|
5.6 |
no step or prerequisite in a callout |
|
5.7 |
15 links |
|
5.8 |
5 heading levels |
GitLab documentation style guide |
5.9 |
7 entries under a sidebar heading |
Mintlify: navigation, which says top-level sections; the rule applies it to every sidebar heading |
5.10 |
alt text of 150 characters |