- 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