Merge branch 'feature/xep-0393'

This commit is contained in:
Jonas Schäfer 2020-05-26 17:44:53 +02:00
commit caa2ad41ef
1 changed files with 21 additions and 7 deletions

View File

@ -26,6 +26,17 @@
<supersededby/>
<shortname>styling</shortname>
&sam;
<revision>
<version>0.2.2</version>
<date>2020-05-20</date>
<initials>ssw</initials>
<remark>
<p>
Clarify accessibility considerations section and be consistent about use
of the term "styling directives".
</p>
</remark>
</revision>
<revision>
<version>0.2.1</version>
<date>2020-01-02</date>
@ -440,22 +451,25 @@
inside preformatted blocks without modification.
</p>
<p>
It is RECOMMENDED that formatting characters be displayed and formatted in
the same manner as the text they apply to.
It is RECOMMENDED that styling directives be displayed and formatted in the
same manner as the text they apply to.
For example, the string "*emphasis*" would be rendered as
"<strong>*emphasis*</strong>".
</p>
</section1>
<section1 topic='Accessibility Considerations' anchor='access'>
<p>
When displaying text with formatting, developers should take care to ensure
sufficient contrast exists between styled and unstyled text so that users
with vision deficiencies are able to distinguish between the two.
When displaying styling directives, developers should ensure sufficient
contrast so that visually impaired users are able to distinguish the styling
directives from the background color.
Care should also be taken to ensure that formatting designed to
differentiate styling directives from surrounding text does not make the
text more difficult to read for visually impaired users.
</p>
<p>
Formatted text may also be rendered poorly by screen readers.
Styled text may also be rendered poorly by screen readers.
When applying formatting it may be desirable to include directives to
exclude formatting characters from being read.
exclude styling directives from being read.
</p>
</section1>
<section1 topic='Security Considerations' anchor='security'>