RE: some questions on Guide Document Template

Hi Tim - here are some thoughts from me. They're just my opinion but based on having been partially involved in the creation of the template. Michael

> 
> (1) Are "key terms" restricted to terms already found in the
> WCAG Glossary (as is implied) or can terms not currently
>   in the Glossary but possibly important to understanding the
> success criterion be also included in this section?

No, key terms are not restricted to the glossary items. Whatever would be helpful to aid understanding should be included here.

> 
> (2) What is the meaning of "background information" in
> "Intent of this SC" section of template?   What kind of
> background information?   Is there an example of such
> background information for a specific success criterion?

There should be an example available soon. This is basically information to describe what is the problem the success criterion is intended to solve.

> 
> (3) What is the scope/purpose of "Related Resources" Section?
> Related in what sense/context?   Can these
> resources be those listed with documented techniques or should
> they be other resources not found with a specific technique?
>    What criterion would be used to list a
> resource in the "Related Resources" Section?   (NOTE: "background
>   information" is listed again in this section, as it is also 
> in the "Intent"
> section - duplication?)

This should be any resource that is useful for people to understand benefits of the success criterion or ways to meet its requirements. There is no need to include our techniques because they are provided elsewhere in the guide. External (non-W3C) information that is relevant should be provided here. "Background information" here might be links to external sites that provide details, even if some of that information was summarized in the section above.

Received on Wednesday, 14 September 2005 20:08:29 UTC