# Unit Test: annotation.001

$Id: annotation.001.xml 5295 2005-10-16 20:39:44Z nwalsh $
Norman Walsh

    ndw@nwalsh.com

Adapted from http://norman.walsh.name/2004/12/02/annotations.xml.

Simple, Inline Annotations

Inline annotations contain only text and other phrase-level markup. They are typically displayed as “tooltips” in a browser.

Block Annotations

Block annotations, like this one, are more akin to footnotes. The browser presentation is a typically a pop-up window.

Another Annotation

This annotation is just a test of what happens when there is more than one.

The last timeMinutes of the October, 2004 telcon the DocBook TCTechnical Committee discussed annotations, there seemed to be consensus on two points. First, that one of the principle motivations for simple, inline annotations is accessibility. Second, that authors will find it easier to use annotations if the distinction between simple, inline annotations and “block” annotations is made on the basis of the element name.

To that end, I've updated the customization layer used here so that the “alt” element is allowed in all inline context. The alt element identifies a simple, inline annotation. The name “alt” has the advantage of being both short and suggestive of the accessibility aspect of this kind of annotation.

The annotation element no longer has a class attribute, it is now used only for block annotations.