Skip to content

Commit 06517d4

Browse files
committed
Update section on lists in writing style guide.
1 parent a889661 commit 06517d4

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

styleguides/writing-style.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -196,14 +196,14 @@ Refer to [UI elements in the Markdown syntax style guide](markdown-syntax-style.
196196

197197
### Lists (bullet lists and numbered steps)
198198

199-
Capitalize the first word—no full stops at the end if it's not a full sentence. If it's a full sentence, give it a full stop/period.
200-
201199
In general:
202200

203201
- Use bullet lists when presenting an unordered list of individual items.
204202
- Use numbered steps when presenting a sequence of instructions/steps that need to be followed.
205203

206-
See also what [Google](https://developers.google.com/style/lists#capitalization-and-end-punctuation) and [Microsoft](https://learn.microsoft.com/en-us/style-guide/scannable-content/lists#punctuation) say about lists.
204+
See also what [Google](https://developers.google.com/style/lists) and [Microsoft](https://learn.microsoft.com/en-us/style-guide/scannable-content/lists) say about lists.
205+
206+
Capitalize the first word—no full stops at the end if it's not a full sentence. If it's a full sentence, give it a full stop/period. See also what [Google](https://developers.google.com/style/lists#capitalization-and-end-punctuation) and [Microsoft](https://learn.microsoft.com/en-us/style-guide/scannable-content/lists#punctuation) say about punctuation in list items.
207207

208208
Refer to [Lists in the Markdown syntax style guide](markdown-syntax-style.md#lists) for details on how to write and present lists in the Buildkite docs.
209209

0 commit comments

Comments
 (0)