Definitions, references, and tooltips

Question for the crowd:  ReSpec today allows you to define terms.  When you
do, you can set a 'title' on the term as a way of telling the system what
the real referencable term should be (e.g., <dfn
title="screenshot">Screenshots</dfn> would define the term Screenshots, but
you would reference it as screenshot).  In bikeshed you can also define
aliases (e.g., <dfn title="screenshot|screenshots|something
else">Screenshots</dfn> would define the term Screenshots, but you would
reference it as screenshot, or screenshots, or 'something else').

Today if there is a 'title' attribute, then ReSpec leaves that on the dfn
element, which in turn means it shows up as a tooltip when you are mousing
around the generated document.

Does anyone think this is a useful feature?  Or it just an accident?  I was
thinking of removing the title attribute during generation - especially as
we introduce the bikeshed syntax.

-- 
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.

Received on Saturday, 1 November 2014 16:48:57 UTC