Images Concepts Tutorial:

instead of

Images Tutorial:

because I renamed the page the title is derived from

as suggested by @slhenry

textual.html

http://www.w3.org/TR/css-2010/#experimental

Suggested by Andrew, as it’s done in the tables

Andrew:

Priority: strong for editor's discretion
Location: concepts and/or tips page
suggestion: emphasis that the document author is best placed to provide the alt text as they know why they included a particular image (rather than the person who might be publishing the information on the web)

@happywebdiva in #57:

To make Example 2 parallel with "Approach 4" of "Complex Images", we might want to indicate this is for HTML5. I haven't added this, though, as it seems beyond copy editing.

http://www.w3.org/WAI/EO/Drafts/tutorials/images/textual/#alternative-approach

OPEN ISSUE: in https://w3c.github.io/wai-tutorials/tables/ambiguous/ example 1 - does this really need scope? ACTION: create table w/ scope and test with browsers.

Most of the bullets say "needs to" and some say "should". Is that a deliberate distinction? If not, I think the same wording should be (or needs to be ;-) used for all of them.

RESOLUTION: To the Table Concepts page, add mini table images showing where the headers are in example tables.

Page: Tables Concepts https://w3c.github.io/wai-tutorials/tables/
Location: opening paragraph "Data tables need structural markup to distinguish between header and data cells and define the relationships between them...."

Is the opening too sentence scarey for newbies? At the end of the page we say "Many web authoring tools and content management systems (CMS) provide functions to define header cells during table creation without having to manually edit the code." -- Does that need to be communicated earlier?

Is the audience primarily people who will be doing markup, or not?

Bar chart showing monthly and total visitors for the first quarter2013 for sites 1 to 3

http://www.w3.org/WAI/EO/Drafts/tutorials/images/complex/#image-containing-substantial-information

• http://www.w3.org/WAI/tutorials/images/informative/#image-conveying-file-format
• Mail reporting the issue: http://w3.org/mid/BCBE0B5B00FF6D4C875E3DED1BC8B87E013D3FA3E682@ES-MSG-EMB-002.es.govt.state.ma.us

alternatives:Imagine

&

attributes:As

Like this, but with correct space:

OVERALL: Use the examples to provide specific examples to explain points. For example, in Irregular Tables, first example: "The scope value row is used on each cell to ensure that it cannot be mistaken as a header for other cells in the same column." -> "The scope value row is used on each cell to ensure that it cannot be mistaken as a header for other cells in the same column -- for example, in the example table below, Belgium should not be mistaken as the heading for France, Holland, etc."

The example is not working in any browser out of the box, yet it is an important and interesting one. We have to clearly communicate that this applies more to a niche use case, if it does.

http://www.w3.org/WAI/EO/Drafts/tutorials/images/textual/#code-snippet-for-math-ml

http://www.w3.org/WAI/EO/Drafts/tutorials/attributions/

Page: Tables Concepts https://w3c.github.io/wai-tutorials/tables/
Location: pages list at the top (Simple tables... Caption & Summary)
Issues: 1. bullets, 2, number of table images:

1. Bullets. I found it much easier to read with the normal bullets (like on https://w3c.github.io/wai-tutorials/images/ ) and the images underneath. I think having the table images first decreases readability. (also, would be better with hanging indents)
2. Images. I envisioned having more than one image under each type - since they cover multiple types of tables...

http://www.w3.org/WAI/EO/Drafts/tutorials/images/textual/#related-wcag20-technique

G94: Providing short text alternative for non-textcontent that serves the same purpose and presents the same information as the non-text content

should be

G94: Providing short text alternative for non-text content that serves the same purpose and presents the same information as the non-text content

Old one: http://www.w3.org/WAI/tutorials/res/beyond

http://www.w3.org/WAI/EO/Drafts/tutorials/images/informative/#image-conveying-succinct-information

bottle top or cap with anti-clockwise arrow

Raised by @happywebdiva & Vicki

The footer also needs some work.

Functional -> Image in a button

http://www.w3.org/WAI/EO/Drafts/tutorials/images/functional/#image-used-in-a-button

Only in IE and that is actually the wrong behavior. Noted when having a look at @happywebdiva’s additions to the images tips page (#60).

Really dislike the name. Maybe "multi-directional tables"? Or "unstructured tables"?

-> Cover Page
-> Tutoral Cover Pages
-> Tips & FAQ?

(This is not urgent and much more FYI.)

The en dash in the Trebuchet MS font is nearly indistinguishable from the hyphen, see:

Here is the same example in Fira Sans:

And here in Arial:

As using an en dash implies meaning, we should think of using another font in the future.

/cc @slhenry

https://www.w3.org/WAI/EO/wiki/Tutorials#Misc

Also add the order number of the page

Shadi:

current wording: "Every image should have a text alternative that provides an equivalent alternative by describing the information or function represented in the image"
suggested revision: "Every image should have a text alternative that describes the information or function represented in the image"

• First paragraph -> roll into first paragraph of the page
• Second paragraph, first sentence -> roll into why is this important

• "if your table doesn't have a column header row, go to Irregular tables Example 1"
• ”Due to how some assistive technology works, it is needed to use the scope attribute if there is only one columns of headers.“ —> Link

Page: Tables Concepts https://w3c.github.io/wai-tutorials/tables/
Location: opening paragraph "Data tables need structural markup to distinguish between header and data cells and define the relationships between them...."

Is the opening too sentence scarey for newbies? At the end of the page we say "Many web authoring tools and content management systems (CMS) provide functions to define header cells during table creation without having to manually edit the code." -- Does that need to be communicated earlier?

Is the audience primarily people who will be doing markup, or not?

CHANGE: Irregular page. Example 2 is unusual. please put it at the end.

Irregular page: Example 3 "Table with headers spanning multiple rows or columns". "In this example, some of the row header cells span two or more rows of data cells and one column header spans three columns." -> "In this example, some of the header cells span multiple rows or columns; for example, the Zodiac row header spans 3 rows, and the Sizes available column header spans 3 columns."

"In the table below, some of the header cells span multiple rows or columns; for example, the Zodiac row header spans 3 rows, and the Sizes available column header spans 3 columns."

http://www.w3.org/WAI/EO/Drafts/tutorials/images/groups/

MINOR: In multi-level page, I'm seeing "Full code for Example 1: Table with multiple column headers in each column (new window)" - missing image? also, that's not on the other pages.