search

rfcseries-wg / new-topics

3 stars 1 forks source link

Improve accessibility with descriptive texts for <svg> and other diagrams #20

Open duerst opened 1 year ago

duerst commented 1 year ago

The current RFCs with diagrams are very thin on descriptive texts with the and elements. This makes it difficult or impossible for sight impaired readers to understand these diagrams, and therefore the RFC they contain. Part of the improvement needed are documentation issues (see e.g. https://github.com/ietf/authors.ietf.org/issues/42) or tools issues (see e.g. https://github.com/ietf-tools/svgcheck/issues/21). What this issue is about is the policy issue of requiring the RPC to check and <desc> elements in <svg> diagrams and other alt-text to make sure that the needs of sight impaired readers are covered. If the RPC tells us they don't need policy in order to add this to their list of work when publishing an RFC, then all the better (and this issue can be closed).</p> </div> </div> <div class="comment"> <div class="user"> <a rel="noreferrer nofollow" target="_blank" href="https://github.com/ajeanmahoney"><img src="https://avatars.githubusercontent.com/u/8966162?v=4" />ajeanmahoney</a> commented <strong> 1 year ago</strong> </div> <div class="markdown-body"> <p>The RPC is updating its procedure for checking artwork to include reviewing the contents of the SVG <code><desc></code> and <code><title></code> elements and the <code><artwork alt=""/></code> attribute (when xml2rfc supports it. Issue opened: <a href="https://github.com/ietf-tools/xml2rfc/issues/898">https://github.com/ietf-tools/xml2rfc/issues/898</a>). If the artwork lacks an accessible description, during AUTH48 the editor will ask the authors to please provide text. We will also update the Online Portion of the Style Guide to recommend to authors that they provide descriptive text for artwork. <a href="https://datatracker.ietf.org/doc/html/draft-flanagan-7322bis-07#section-3.7">rfc7322bis</a> already captures a recommendation regarding artwork accessibility. </p> </div> </div> <div class="page-bar-simple"> </div> <div class="footer"> <ul class="body"> <li>© <script> document.write(new Date().getFullYear()) </script> Githubissues.</li> <li>Githubissues is a development platform for aggregating issues.</li> </ul> </div> <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js"></script> <script src="/githubissues/assets/js.js"></script> <script src="/githubissues/assets/markdown.js"></script> <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.4.0/build/highlight.min.js"></script> <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.4.0/build/languages/go.min.js"></script> <script> hljs.highlightAll(); </script> </body> </html>