On Mon, Oct 5, 2009 at 12:22 PM, Kevin Horn <kevin.horn@gmail.com> wrote:
I've been looking over the xhtml documents used to generate the twisted documentation, and I've noticed a number of issues:

Are these issues really affecting you in some way?
 
I'm planning to correct some of these issues, but I wanted to get others' opinions on exactly how to go about it.  For example, what DOCTYPE to use, XMLNS to use, etc.

They are supposed to be XHTML, so they should be annotated as appropriate for that format.  Lore doesn't define its own attributes, on purpose: it uses existing XHTML facilities like "class" to encode its metadata.
 
Thoughts?  Suggestions?
 
I'm sure we'd be happy to accept some patches to clean these documents up, especially if it's bothering you, but it seems pretty low-priority to me :).