[Doc-SIG] The Use of Roles

fantasai fantasai at escape.com
Tue Jun 10 18:14:04 EDT 2003

David Priest wrote:
> Should the reader have some idea 
> of what's a valid role, or should it 
> just toss anything it doesn't know 
> about into the class name and let 
> the writers deal with it?  I can see 
> arguments either way.

I'd say just toss it into the class name.
The writer could then have a default handler for
anything it doesn't specifically recognize. In
HTML, it would be <span class="unrecognized-role">,
in DocBook maybe <phrase role="unrecognized-role">.
In some other format, it could be just to ignore
the tags and handle the element's content.


More information about the Doc-SIG mailing list