[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