- From: Fred Esch <fesch@us.ibm.com>
- Date: Wed, 25 May 2016 10:36:03 -0400
- To: "Douglas Schepers" <schepers@w3.org>
- Cc: <public-svg-a11y@w3.org>
- Message-Id: <20160525143706.50DF1C6037@b03ledav006.gho.boulder.ibm.com>
Doug, Editorial comments on the SVG Authoring Guide. These are all wordsmithing and don't change meaning. Abstract Do you want to use the word performant? It is used in a few W3C docs, but performant is generally not considered a word (outside of use as reference to a performance). Introduction You avoided using the term normative (actually non normative). Is this intentional so it is easier to read? The list of attributes all have the able suffix. Can we rewrite it to avoid using the suffix? Something like Specifically, this document demonstrates practical techniques for making SVG documents that you can: restyle animate resize navigate read with a screen readers use as a component in other SVG search and index with a search engine and other text-based applications use in different authoring and viewing applications The last paragraph I would suggest replacing These are some techniques that are generally with This guide uses techniques that are and replace Some techniques with And some techniques so the updated paragraph would read This guide uses techniques that are applicable across different use cases, including document structure, document order, navigation, and text and text alternatives. And some techniques are unique to specific use cases, such as icons complex images, data visualizations, animated pictures, interactive applications, or text-heavy images, each have their own optimization. Definitions replaced element has stuff like image tags that are not showing up in the text General Techniques I assume this is placeholder text. It doesn't make sense the way it is. Structure You need hierarchical headings under structure. Shape Composition, Grouping and Nesting Regards, Fred Esch Watson, IBM, W3C Accessibility IBM Watson Watson Release Management and Quality
Attachments
- image/gif attachment: 0A188244.gif
Received on Wednesday, 25 May 2016 14:37:50 UTC