w3c / wai-tutorials

Important

This repository has been archived 11 July 2024.

Tutorials are now edited in the wai-website repository.

Archived information

Publication branch

The branch deployed to the website is the publication branch. More info on requesting deploys is in Updating WAI Website Resources

Translation Notes

See Resource-Specific Translation Instructions

wai-tutorials's Issues

Minor: Missing space in textual tutorial

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

Described by @ complex images

Add note about HTML5 compatibility

@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.

Images Concepts bullet points

Raised by @happywebdiva & Vicki

Left Navigation: Heading appearance

Reference ATAG from concept page

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

Create “Beyond Tutorial” page

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

Trebuchet font not displaying en dashes correctly

(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

Informative images: “format.” missing in Example “Image conveying file format”

• http://www.w3.org/WAI/tutorials/images/informative/#image-conveying-file-format
• Mail reporting the issue: http://w3.org/mid/[e-mail]

Feedback: Browser/AT support for MathML demo

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

Images concepts page "needs to" or "should"?

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.

Add note on who should provide alt text

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)

Link to Irregular->First Example from simple tables

• "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

Missing image in “Informative images → Image conveying succinct information”

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

bottle top or cap with anti-clockwise arrow

Minor: FAQ: Space behind colon

alternatives:Imagine

&

attributes:As

Multi-Level, remove (new window) text

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.

Tables Concepts page too scarey/advanced?

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?

Topic Navigation: Have current topic marked on every page of a topic, not only at the concepts pages

Add SVG on tips page

Style search submit button

Functional -> Image in a button

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

Add mini table to the Table Concepts page

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

Feedback: Alternative approach @ Textual Images Tutorial

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

Add Attribution Page to the Footer

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

"Ambiguous Tables"

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

Do we need the “How to make tables accessible”

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

Add sentence that the alt isn’t shown as a tool tip in most browsers

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).

Irregular page: Example 3: Text enhancements

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."

Wording: First Sentence

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"

Browser testing

Irregular tables ex. 2 to the end?

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

Rethink Permalinks

Tables Concepts: Add intendation to the list

Like this, but with correct space:

Missing Example in Complex Images

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

fix Navigation when menu items are on two lines

Irregular Tables: Does Example 1 need scope

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.

Tables Concepts page intro too scarey/advanced?

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?

Add Text Previous/Next to arrows on the bottom

Also add the order number of the page

New Breadcrumb icons

Add link to vendor prefixes

textual.html

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

Footer display

The footer also needs some work.

Table Concepts images of tables

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...

Add Success criteria for image cover page

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

Feedback: ARIA Example for Groups of Images?

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

First paragraph of irregular tables: impossible instead of hard

Mention decision tree on images cover page

as suggested by @slhenry

Wrong navigation heading

Images Concepts Tutorial:

instead of

Images Tutorial:

because I renamed the page the title is derived from

Provide more specific examples

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."

Add image with arrows to the irregular tables tutorial

Change permalink positioning

Feedback: Notes style

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