Re: PROPOSAL: Capture terminology in stand-alone glossary document

> On May 2, 2015, at 6:17 AM, Adrian Hope-Bailie <adrian@hopebailie.com> wrote:
> 
> Thanks Ian.
> 
> Do we need to then include the terminology in other documents or is it sufficient to reference the glossary?

Personally, I think it will be easier to have the minimum number of terms inline. (So Manu is working on how to do that with respec.)

Ian

> 
> I think we should consider including some of the terms from the Gates Foundation's Level One glossary which seems to have been very well put together to be easy to consume for a less informed audience. They aren't all applicable probably and we certainly have some additions but it's a good reference.
> 
> https://leveloneproject.org/the-guide/glossary-of-terms/
> 
> Adrian
> 
> 
> 
> 
> 
> On 1 May 2015 at 19:34, Ian Jacobs <ij@w3.org> wrote:
> 
> > On May 1, 2015, at 11:37 AM, Adrian Hope-Bailie <adrian@hopebailie.com> wrote:
> >
> > As we begin formulating the architecture document it appears that we are replicating the set of terms from the use case document.
> >
> > Trying to maintain multiple copies of the same content across what may end up being numerous documents is a recipe for confusion and inefficiency.
> >
> > Since this content is key to all of our work does it not make sense to capture this in a  stand-alone document that can be referenced from both the use cases and architecture docs and any other docs that we produce in future.
> >
> > Precedent that I could find:
> 
> Hi Adrian,
> 
> We have a glossary task force and all share the goal of having uniform vocabulary usage. Manu is working on tools to mechanically include terms that may be defined in one place. I don’t think that work has been completed yet.
> 
> We are also looking at how to keep the terms as simple as possible for a broad readership, while at the same time having “mappings” from our terms to those (similar terms) used in other standards. Evert has led that work and is looking for feedback on this kin of approach:
>  https://www.w3.org/Payments/IG/wiki/GlossaryReference
> 
> I’ve taken Evert’s page and turned it into this:
> 
>  EXPERIMENT: Web Payments Glossary
>  http://www.w3.org/2015/04/wpay-glossary
> 
> Summary:
> 
>  * I believe there is strong agreement to manage terms carefully including defining them in one place
>  * There is also agreement to use them where needed in specs (by importing them from a single source)
>  * There is also agreement to map them to other definitions found in the broader ecosystem.
> 
> Ian
> 
> >
> > http://www.w3.org/TR/2004/NOTE-ws-gloss-20040211/
> > http://www.w3.org/TR/2013/NOTE-ld-glossary-20130627/
> > http://www.w3.org/TR/2014/NOTE-mbui-glossary-20140107/
> >
> > Please can this be put on the agenda for Monday's call?
> 
> --
> Ian Jacobs <ij@w3.org>      http://www.w3.org/People/Jacobs
> Tel:                       +1 718 260 9447
> 
> 
> 
> 

--
Ian Jacobs <ij@w3.org>      http://www.w3.org/People/Jacobs
Tel:                       +1 718 260 9447

Received on Saturday, 2 May 2015 13:05:07 UTC