<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>28871</bug_id>
          
          <creation_ts>2015-07-01 03:20:44 +0000</creation_ts>
          <short_desc>Consistent presentation of mapping details across AAM documents</short_desc>
          <delta_ts>2018-05-03 20:14:32 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>ARIA</product>
          <component>Core AAM</component>
          <version>1.1</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WONTFIX</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Jason Kiss">jason</reporter>
          <assigned_to name="Joseph Scheuhammer">clown</assigned_to>
          <cc>faulkner.steve</cc>
    
    <cc>surkov.alexander</cc>
    
    <cc>w3cbugzilla</cc>
          
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>121542</commentid>
    <comment_count>0</comment_count>
    <who name="Jason Kiss">jason</who>
    <bug_when>2015-07-01 03:20:44 +0000</bug_when>
    <thetext>At least with regard to Core-AAM and HTML-AAM, it would be good for the mapping tables to be structured the same as much as possible, and for the specific mapping details to be presented in the same way.

While I might be biased, I prefer the HTML-AAM approach where the mapping table column headers note the name of the AAPI, e.g. &quot;MSAA + IAccessible2&quot;, over the Core-AAM where the column headers are more specific, e.g. &quot;MSAA + IAccessible2 Role + Other IAccessible2 Features. 

I prefer the HTML-AAM approach because the particular AAPI features and properties (roles, control types, localized control types, object attributes, states, events, interfaces, etc.) being defined are, for the most part (it&apos;s not perfect and there are still improvements to be made) expressly identified in a clear and consistent fashion. For example, see the mappings for the HTML caption element [1].

There is a degree of inconsistency in how the AAPI roles and features are presented for the ARIA roles in the Core-AAM. Granted, there&apos;s some inconsistency in the HTML-AAM as well, but I think the more explicit identification of the feature, i.e. role or control type or control pattern or state, etc. is an approach that results in a clearer specification.

While I have my preference as noted above, my greater concern is that whatever  approach is taken is used consistently across both the HTML-AAM and Core-AAM, given the especially close relationship between the two specs.


[1] http://rawgit.com/w3c/aria/master/html-aam/html-aam.html#el-caption</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>