search

w3c / wai-media-guide

11 stars 41 forks source link

[Planning] Standards its own page? #34

Closed kakinney closed 5 years ago

kakinney commented 5 years ago

Having the standards listed at the bottom of the planning page felt disjointed to me. I feel like they should be listed on the introduction page, or have their own separate page. if they have a separate page, I would list it as:

  1. Introduction
  2. Standards
  3. Planning
  4. All the techniques to meet those standards as they are listed.
shawna-slh commented 5 years ago

Yeah, where to put standards was a tough one! Back in April and early May, we tried several options, including:

When making the final decision on organization in May, we thought more about the Tasks in the Requirements Analysis.

We actually do not want this practical-guidance-for-getting-it-done resource to have emphasis on standards. For example, see the Tutorials (e.g., labeling controls), where standards are only mentioned at the bottom of relevant pages.

Throughout the resource, I have added links to that standards section, so readers can get there when they need to.

Are you OK going with the EOWG's previous decision and leaving Standards where it is?

yatil commented 5 years ago

(editor’s discretion) I am ok with leaving it, but it is a substantial part (25%) of the resource. If we would use a tutorial-like info-box approach just listing SCs, we could have them contextually on the individual pages. However this seems a little bit excessive for planning. I have no better idea apart from using a separate page. And I do not want to re-open this issue.

shawna-slh commented 5 years ago

We chose not to have the SCs on the individual pages because we deemed it more important to show the overall view of that is in WCAG.

it is a substantial part (25%) of the resource

-> it is a substantial part (25%) of this one page of the resource

And I do not want to re-open this issue.

+1 from me :-)

Hopefully Kris Anne, too. :-)