[Twisted-Python] Structural issues in Lore XHTML documents

Glyph Lefkowitz glyph at twistedmatrix.com
Mon Oct 5 14:25:53 EDT 2009


On Mon, Oct 5, 2009 at 12:22 PM, Kevin Horn <kevin.horn at 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 :).
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://twistedmatrix.com/pipermail/twisted-python/attachments/20091005/3b826688/attachment.htm 


More information about the Twisted-Python mailing list