<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Thu Feb 08 23:26:34 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary add field=key&field=summary to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>FOLIO Jira</title>
    <link>https://folio-org.atlassian.net</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>1001.0.0-SNAPSHOT</version>
        <build-number>100246</build-number>
        <build-date>07-02-2024</build-date>
    </build-info>

<item>
            <title>[FOLIO-3229] Replace Headline &lt;div&gt; tag by &lt;h1&gt; ... &lt;h6&gt;</title>
                <link>https://folio-org.atlassian.net/browse/FOLIO-3229</link>
                <project id="10290" key="FOLIO">FOLIO</project>
                    <description>&lt;p&gt;Headlines should use &amp;lt;h1&amp;gt; ... &amp;lt;h6&amp;gt; tags to provide semantic code for headings in the content. Heading markup will allow assistive technologies like screenreaders to present the heading status of text to a user.&lt;/p&gt;

&lt;p&gt;The default tag of a Stripes Headline is &amp;lt;div&amp;gt;, see Headline documentation: &lt;a href=&quot;https://github.com/folio-org/stripes-components/tree/master/lib/Headline&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://github.com/folio-org/stripes-components/tree/master/lib/Headline&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Properly using &amp;lt;h1&amp;gt; ... &amp;lt;h6&amp;gt; is a WCAG 2.1 Level A requirement:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;&lt;a href=&quot;https://www.w3.org/WAI/WCAG21/Techniques/html/H42&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://www.w3.org/WAI/WCAG21/Techniques/html/H42&lt;/a&gt; &quot;Using h1-h6 to identify headings&quot;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;https://www.w3.org/WAI/WCAG21/Techniques/general/G141&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://www.w3.org/WAI/WCAG21/Techniques/general/G141&lt;/a&gt; &quot;Organizing a page using headings&quot;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships&lt;/a&gt; &quot;Understanding Success Criterion 1.3.1: Info and Relationships&quot;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;Many modules use the default resulting in bad accessibility and WCAG violation - only 153 out of 263 &amp;lt;Headline&amp;gt; usages change the &amp;lt;div&amp;gt; tag, see attached &lt;span class=&quot;nobr&quot;&gt;&lt;a href=&quot;/rest/api/3/attachment/content/64394&quot; title=&quot;headline.txt attached to FOLIO-3229&quot; data-attachment-type=&quot;file&quot; data-attachment-name=&quot;headline.txt&quot; data-media-services-type=&quot;file&quot; data-media-services-id=&quot;1851a6b6-8bb4-40c9-988d-703dc35925fa&quot; rel=&quot;noreferrer&quot;&gt;headline.txt&lt;sup&gt;&lt;img class=&quot;rendericon&quot; src=&quot;/images/icons/link_attachment_7.gif&quot; height=&quot;7&quot; width=&quot;7&quot; align=&quot;absmiddle&quot; alt=&quot;&quot; border=&quot;0&quot;/&gt;&lt;/sup&gt;&lt;/a&gt;&lt;/span&gt; file:&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
cd platform-complete/node_modules/@folio
grep -rPazo &lt;span class=&quot;code-quote&quot;&gt;&quot;&amp;lt;Headline[^&amp;gt;]*&amp;gt;&quot;&lt;/span&gt; | tr \\0 \\n | grep Headline | wc -l
263
grep -rPazo &lt;span class=&quot;code-quote&quot;&gt;&quot;&amp;lt;Headline[^&amp;gt;]*&amp;gt;&quot;&lt;/span&gt; | tr \\0 \\n | grep &lt;span class=&quot;code-quote&quot;&gt;&quot;tag&quot;&lt;/span&gt; | wc -l
153
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;asd &lt;/p&gt;

&lt;p&gt;This umbrella is to fix each usage of a Stripes Headline where a wrong HTML tag is used.&lt;/p&gt;
&lt;h2&gt;&lt;a name=&quot;Background&quot;&gt;&lt;/a&gt;Background&lt;/h2&gt;

&lt;p&gt;Details about this problem cited from the WCAG pages listed above:&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://www.w3.org/WAI/WCAG21/Techniques/html/H42&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://www.w3.org/WAI/WCAG21/Techniques/html/H42&lt;/a&gt; &quot;Using h1-h6 to identify headings&quot;:&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;The objective of this technique is to use HTML and XHTML heading markup to provide semantic code for headings in the content. Heading markup will allow assistive technologies to present the heading status of text to a user. A screen reader can recognize the code and announce the text as a heading with its level, beep or provide some other auditory indicator. Screen readers are also able to navigate heading markup which can be an effective way for screen reader users to more quickly find the content of interest. Assistive technologies that alter the authored visual display will also be able to provide an appropriate alternate visual display for headings that can be identified by heading markup.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://www.w3.org/WAI/WCAG21/Techniques/general/G141&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://www.w3.org/WAI/WCAG21/Techniques/general/G141&lt;/a&gt; &quot;Organizing a page using headings&quot;:&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;The objective of this technique is to ensure that sections have headings that identify them. Success Criterion 1.3.1 requires that the headings be marked such that they can be programmatically identified.&lt;/p&gt;

&lt;p&gt;In HTML, this could be done using the HTML heading elements (h1, h2, h3, h4, h5, and h6). These allow user agents to automatically identify section headings. Other technologies use other techniques for identifying headers. To facilitate navigation and understanding of overall document structure, authors should use headings that are properly nested (e.g., h1 followed by h2, h2 followed by h2 or h3, h3 followed by h3 or h4, etc.).&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships&lt;/a&gt; &quot;Understanding Success Criterion 1.3.1: Info and Relationships&quot;:&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;The intent of this Success Criterion is to ensure that information and relationships that are implied by visual or auditory formatting are preserved when the presentation format changes. For example, the presentation format changes when the content is read by a screen reader or when a user style sheet is substituted for the style sheet provided by the author.&lt;/p&gt;

&lt;p&gt;Sighted users perceive structure and relationships through various visual cues &#8212; headings are often in a larger, bold font separated from paragraphs by blank lines; list items are preceded by a bullet and perhaps indented; paragraphs are separated by a blank line; items that share a common characteristic are organized into tabular rows and columns; form fields may be positioned as groups that share text labels; a different background color may be used to indicate that several items are related to each other; words that have special status are indicated by changing the font family and /or bolding, italicizing, or underlining them; items that share a common characteristic are organized into a table where the relationship of cells sharing the same row or column and the relationship of each cell to its row and/or column header are necessary for understanding; and so on. Having these structures and these relationships programmatically determined or available in text ensures that information important for comprehension will be perceivable to all.&lt;/p&gt;

&lt;p&gt;Auditory cues may be used as well. For example, a chime might indicate the beginning of a new section; a change in voice pitch or speech rate may be used to emphasize important information or to indicate quoted text; etc.&lt;/p&gt;

&lt;p&gt;When such relationships are perceivable to one set of users, those relationships can be made to be perceivable to all. One method of determining whether or not information has been properly provided to all users is to access the information serially in different modalities.&lt;/p&gt;
&lt;h3&gt;&lt;a name=&quot;Benefits&quot;&gt;&lt;/a&gt;Benefits&lt;/h3&gt;
&lt;ul&gt;
	&lt;li&gt;This Success Criterion helps people with different disabilities by allowing user agents to adapt content according to the needs of individual users.&lt;/li&gt;
&lt;/ul&gt;
&lt;/blockquote&gt;</description>
                <environment></environment>
        <key id="82138">FOLIO-3229</key>
            <summary>Replace Headline &lt;div&gt; tag by &lt;h1&gt; ... &lt;h6&gt;</summary>
                <type id="10006" iconUrl="https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10307?size=medium">Umbrella</type>
                            <parent id="13685">UXPROD-216</parent>
                                    <priority id="10005" iconUrl="https://dev.folio.org/assets/jira-priority/tbd.svg">TBD</priority>
                        <status id="6" iconUrl="https://folio-org.atlassian.net/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="green"/>
                                    <resolution id="10000">Won&apos;t Do</resolution>
                                                        <assignee accountid="-1">Unassigned</assignee>
                                                                <reporter accountid="5ee89462f7aa140abd82d11d">Julian Ladisch</reporter>
                                    <labels>
                            <label>a11y</label>
                    </labels>
                <created>Tue, 6 Jul 2021 15:37:41 +0000</created>
                <updated>Fri, 17 Sep 2021 13:29:10 +0000</updated>
                            <resolved>Wed, 21 Jul 2021 11:55:09 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                <comments>
                                                            <comment id="197847" author="62a96ae7192edb006f9f1bf9" created="Mon, 12 Jul 2021 15:33:25 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=5ee89462f7aa140abd82d11d&quot; class=&quot;user-hover&quot; rel=&quot;5ee89462f7aa140abd82d11d&quot; data-account-id=&quot;5ee89462f7aa140abd82d11d&quot; accountid=&quot;5ee89462f7aa140abd82d11d&quot; rel=&quot;noreferrer&quot;&gt;Julian Ladisch&lt;/a&gt;, can you provide details as to what problems you want to solve with this suggestion? &lt;/p&gt;</comment>
                                                            <comment id="197850" author="5ee89462f7aa140abd82d11d" created="Mon, 19 Jul 2021 22:43:11 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=62a96ae7192edb006f9f1bf9&quot; class=&quot;user-hover&quot; rel=&quot;62a96ae7192edb006f9f1bf9&quot; data-account-id=&quot;62a96ae7192edb006f9f1bf9&quot; accountid=&quot;62a96ae7192edb006f9f1bf9&quot; rel=&quot;noreferrer&quot;&gt;Khalilah Gambrell&lt;/a&gt; I&apos;ve added details about the accessibility problem to the issue description.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10000">
                    <name>Blocks</name>
                                            <outwardlinks description="blocks">
                                        <issuelink>
            <issuekey id="55215">STCOM-857</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                            <issuelinktype id="10008">
                    <name>Defines</name>
                                                                <inwardlinks description="is defined by ">
                                        <issuelink>
            <issuekey id="65373">UICHKOUT-744</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10003">
                    <name>Relates</name>
                                                                <inwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="55212">STCOM-856</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                            <attachment id="64394" name="headline.txt" size="32057" author="5ee89462f7aa140abd82d11d" created="Wed, 21 Jul 2021 15:55:42 +0000"/>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10000" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummarycf">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10057" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Development Team</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10168"><![CDATA[None]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10014" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue key="$xmlutils.escape($text)">Accessibility: WCAG 2.1 AA Compliance.</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10063" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>PO Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10019" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|i031pj:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10020" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10024" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>[CHART] Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Mon, 12 Jul 2021 15:33:25 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10025" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>[CHART] Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                    </customfields>
    </item>
</channel>
</rss>