Skip to content

Commit 2741dae

Browse files
authored
(DOCSP-36170): Updated stem sentence guidance. (#166)
* (DOCSP-36170): Updated stem sentence guidance. * (DOCSP-36170): Incorporated feedback. * (DOCSP-36170): Incorporated Chris's feedback.
1 parent fd16cd5 commit 2741dae

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

source/style-guide/style/lists.txt

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,16 @@ guidelines when introducing lists.
3939
period instead of a colon.
4040

4141
.. note::
42-
Avoid using fragments to introduce lists. Fragments can be
43-
harder to understand than sentences.
42+
43+
Avoid using a fragment to introduce a list. Users might
44+
find a fragment more difficult to understand than a full
45+
sentence. If a full sentence makes the introduction awkward
46+
or redundant, use a sentence stem to introduce the list and
47+
ensure the list items complete the sentence. Consider
48+
accessibility and screen readers because introductory text
49+
plays a crucial role in providing context and navigation cues
50+
for individuals who rely on auditory output. To learn more,
51+
see `Section508 <https://www.section508.gov/>`__.
4452

4553
- You can use this product to perform the following tasks:
4654

0 commit comments

Comments
 (0)