On Mon, Oct 5, 2009 at 12:22 PM, Kevin Horn <kevin.h...@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 :).
_______________________________________________
Twisted-Python mailing list
Twisted-Python@twistedmatrix.com
http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python

Reply via email to