[Doc-SIG] The Use of Roles

David Goodger goodger at python.org
Tue Jun 10 14:12:40 EDT 2003


Beni Cherniavsky wrote:
> I think the criterion should be ignorability.  If you strip all
> `class` attributes, you should still get acceptable results.  E.g. I
> think that a `kbd` role should become a `literal` element with ``kbd``
> style.  Ask yourself what's the closest approximations to each
> proposed role.  It might be unmarked plain text - then `inline` fits.
> It might have no acceptable approximation - then a new element might
> be in order.

Well put!

-- David Goodger




More information about the Doc-SIG mailing list