Changes between Version 12 and Version 13 of interaction-design/getting-started


Ignore:
Timestamp:
02/21/14 18:02:27 (5 years ago)
Author:
nhoyt
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • interaction-design/getting-started

    v12 v13  
    33[wiki:interaction-design/getting-started Getting Started] 
    44 
    5 = Getting Started: Conceptual Foundation 
     5{{{ 
     6#!html 
     7<h2 id="gettingstarted:conceptualfoundation">Getting Started: Conceptual Foundation</h2> 
    68 
    7 All web accessibility tools that are based on the !OpenAjax Alliance Evaluation Library assume a familiarity with the following concepts: 
     9<p>All web accessibility tools that are based on the OpenAjax Alliance Evaluation Library assume a familiarity with the following concepts.</p> 
    810 
    9   Accessibility rule:: A low-level compliance requirement with numerous components, the most basic of which are a //definition//, an //evaluation function//, and //result messages//. When a rule is evaluated, it is assigned a //rule result value//. 
     11<h3 id="basicconcepts">Basic Concepts</h3> 
     12<dl> 
     13<dt><em>Rule</em></dt> 
     14<dd>A low-level compliance requirement with numerous components, the most basic of which are a <em>definition</em>, an <em>evaluation function</em>, and <em>result messages</em>. When a rule is evaluated, it is assigned a <em>rule result value</em>.</dd> 
    1015 
    11   Target resources:: The set of HTML elements to which a particular rule applies. This may include a pseudo-element identified as //page//, which is a placeholder for the document element. When a rule is evaluated, each of its target resources is assigned an //element result value//. 
     16<dt><em>Target resources</em></dt> 
     17<dd>The set of HTML elements to which a particular rule applies. This may include a pseudo-element identified as <em>page</em>, which is a placeholder for the document element. When a rule is evaluated, each of its target resources is assigned an <em>element result value</em>.</dd> 
    1218 
    13   Ruleset:: A set of rules that embodies specific standards compliance goals. Each rule within a ruleset can be designated as either //required// or //recommended//, according to its relationship to the compliance goals of the ruleset. 
     19<dt><em>Ruleset</em></dt> 
     20<dd>A set of rules that embodies specific standards compliance goals. Each rule within a ruleset can be designated as either <em>required</em> or <em>recommended</em>, according to its relationship to the compliance goals of the ruleset.</dd> 
    1421 
    15   Evaluation:: The application of all evaluation functions of all rules in the selected ruleset to their corresponding target resources in a web page, and the subsequent collection of all evaluation results and messages, at both the rule and element levels, into a dataset. 
     22<dt><em>Evaluation</em></dt> 
     23<dd>The application of all evaluation functions of all rules in the selected ruleset to their corresponding target resources in a web page, and the subsequent collection of all evaluation results and messages, at both the rule and element levels, into a dataset.</dd> 
    1624 
    17   Rule result:: The aggregate result of a rule evaluation with respect to its target resources (all of its target elements and/or the entire page). 
     25<dt><em>Rule result</em></dt> 
     26<dd>The aggregate result of a rule evaluation with respect to its target resources (all of its target elements and/or the entire page).</dd> 
    1827 
    19   Element result:: The result of a rule evaluation with respect to one of its target elements. 
     28<dt><em>Element result</em></dt> 
     29<dd>The result of a rule evaluation with respect to one of its target elements.</dd> 
     30</dl> 
    2031 
    21   Rule and element result values:: 
    22 || V || Violation || One or more target elements fail the requirements of a //required// rule || 
    23 || W || Warning || One or more target elements fail the requirements of a //recommended// rule || 
    24 || MC || Manual Check || Unable to programmatically determine a result - evaluation requires human inspection || 
    25 || P || Pass || All rule requirements were satisfied || 
    26 || H || Hidden || Target elements were not evaluated because they are hidden (either visually or from assistive technologies) || 
    27 || N/A or '-' || Not Applicable || Rule was not applied because there were no relevant target elements || 
    2832 
     33<h3 id="ruleandelementresultvalues">Rule and element result values</h3> 
     34 
     35<table border="1" cellspacing="0"> 
     36<colgroup> 
     37<col style="text-align:left;"/> 
     38<col style="text-align:left;"/> 
     39</colgroup> 
     40 
     41<thead> 
     42<tr> 
     43        <th style="text-align:left;" colspan="2">Value/Abbrev.</th> 
     44        <th style="text-align:left;">Meaning</th> 
     45</tr> 
     46</thead> 
     47 
     48<tbody> 
     49<tr> 
     50        <td style="text-align:left;">Violation</td> 
     51        <td style="text-align:left;">V</td> 
     52        <td style="text-align:left;">One or more target elements fail the requirements of a <em>required</em> rule</td> 
     53</tr> 
     54<tr> 
     55        <td style="text-align:left;">Warning</td> 
     56        <td style="text-align:left;">W</td> 
     57        <td style="text-align:left;">One or more target elements fail the requirements of a <em>recommended</em> rule</td> 
     58</tr> 
     59<tr> 
     60        <td style="text-align:left;">Manual Check</td> 
     61        <td style="text-align:left;">MC</td> 
     62        <td style="text-align:left;">Unable to programmatically determine a result - evaluation requires human inspection</td> 
     63</tr> 
     64<tr> 
     65        <td style="text-align:left;">Pass</td> 
     66        <td style="text-align:left;">P</td> 
     67        <td style="text-align:left;">All rule requirements were satisfied</td> 
     68</tr> 
     69<tr> 
     70        <td style="text-align:left;">Hidden</td> 
     71        <td style="text-align:left;">H</td> 
     72        <td style="text-align:left;">Target elements were not evaluated because they are hidden (either visually or from assistive technologies)</td> 
     73</tr> 
     74<tr> 
     75        <td style="text-align:left;">Not Applicable</td> 
     76        <td style="text-align:left;">N/A or &#8216;-&#8217;</td> 
     77        <td style="text-align:left;">Rule was not applied because there were no relevant target elements</td> 
     78</tr> 
     79</tbody> 
     80</table> 
     81<h3 id="moreaboutrulestargetresourcesandresultvalues">More about rules, target resources and result values</h3> 
     82 
     83<ul> 
     84<li>A rule tests target resources for specific accessibility features.</li> 
     85<li>Some rules are fully automated and return pass or fail results and messages.</li> 
     86<li>Other rules can only identify the need for human judgement to determine if an accessibility requirement has been met. These return manual check results and messages.</li> 
     87<li>If target resources are not found on the page, the rule result is designated as not applicable.</li> 
     88<li>If target resources for a rule are hidden, the rule result is designated as hidden. The hidden resources are included in the element results list to encourage developers to consider their accessibility if and when they become available to users.</li> 
     89<li>Rules also include information on accessibility techniques and links to related resources to help developers understand how to meet the rquirements of a rule.</li> 
     90</ul> 
     91}}}