W3C home > Mailing lists > Public > public-cognitive-a11y-tf@w3.org > November 2014

Fw: Action Item: WAI Glossary of terms

From: Richard Schwerdtfeger <schwer@us.ibm.com>
Date: Mon, 3 Nov 2014 12:35:20 -0600
To: "lisa.seeman" <lisa.seeman@zoho.com>
Cc: public-cognitive-a11y-tf <public-cognitive-a11y-tf@w3.org>
Message-ID: <OF77C2AB59.45C00F1F-ON86257D85.00641D4D-86257D85.00661C98@us.ibm.com>


Hi Lisa,

It turns out we make use of the respec @data-include function to include
important terms

                                                                      
 <section id="glossary">                                              
                                                                      
 <h2>Important Terms</h2>                                             
                                                                      
 <p>This section is <a class="termref">normative</a>.</p>             
                                                                      
 <div data-include="../common/terms.html"                             
 data-oninclude="fixIncludes"></div>                                  
                                                                      
 </section>                                                           
                                                                      



Our glossary is relatively small and, although we may use these terms in
future coga specs., I think we need a separate glossary for the research
document that covers medical terms used in coga.

So, my recommendation is that we use the respec feature to include our own
glossary terms for now and borrow the code from WAI-ARIA to build our own
glossary. I agree the Glossary should be at the end of the spec.

Gap to fill: Part of our roadmap must be to bring the broader web
population up to speed as to what these medical terms mean in a way that
makes sense to developers. I am glad we are looking at Web 2020.


Best,
Rich



Rich Schwerdtfeger
----- Forwarded by Richard Schwerdtfeger/Austin/IBM on 11/03/2014 12:13 PM
-----

From:	Joseph Scheuhammer <clown@alum.mit.edu>
To:	Richard Schwerdtfeger/Austin/IBM@IBMUS, cooper@w3.org
Date:	11/03/2014 11:53 AM
Subject:	Re: WAI Glossary of terms



On 2014-11-03 12:44 PM, Richard Schwerdtfeger wrote:
> Is there a WAI glossary document that we can extend for other groups.

I don't know.

> I can't recall how the glossary is pulled in for WAI-ARIA.

The file is in https://github.com/w3c/aria/blob/master/common/terms.html.

The ARIA documents use ReSpec's use of @data-include.  See, for example:
https://github.com/w3c/aria/blob/master/accname-aam/accname-aam.html#L479

The ReSpec documentation is here:
http://www.w3.org/respec/guide.html#inclusions-transformations

Hope that helps.

--
;;;;joseph.

'Array(16).join("wat" - 1) + " Batman!"'
            - G. Bernhardt -
Received on Monday, 3 November 2014 18:36:01 UTC

This archive was generated by hypermail 2.4.0 : Thursday, 24 March 2022 20:23:50 UTC