ReSpec changes for definitions

Hi all!

If you are using the <dfn> and <a> features of ReSpec to handle linking to
your definitions, you will notice that there is a new warning related to
this.  We have deprecated support for @title on definitions and <a>
attributes.  This is to more closely align with Bikeshed (another
publication tool) and to make @title available for use with A11Y or other
features.

At the same time, we have added a feature where you can define *aliases* for
your terms using the 'lt' attribute.  You can do aliases with a form like:

<dfn lt="term|terms|my term|another name">My Term</dfn>

You can reference this using <a>terms</a> (or any of its defined forms).
You can also reference it using <a lt="term">some string that is not an
alias</a> if you like.

You will get warnings about your use of @title for a while.  At some point
we pla on removing support for @title altogether.

Let me know if you have any questions.

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

Received on Wednesday, 29 July 2015 20:44:35 UTC