<div class="gmail_quote">On Mon, Oct 5, 2009 at 1:25 PM, Glyph Lefkowitz <span dir="ltr"><<a href="mailto:glyph@twistedmatrix.com">glyph@twistedmatrix.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="gmail_quote"><div class="im">On Mon, Oct 5, 2009 at 12:22 PM, Kevin Horn <span dir="ltr"><<a href="mailto:kevin.horn@gmail.com" target="_blank">kevin.horn@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
I've been looking over the xhtml documents used to generate the twisted documentation, and I've noticed a number of issues:<br></blockquote></div><div><br>Are these issues really affecting you in some way?<br></div>
</div></blockquote><div><br>Yes and no. I'm playing around with some automated processing of these documents (mostly as an exercise to learn lxml), and I'm having to work around some of these things. And since I was thinking about it anyway, I thought I'd take the opportunity to fix up some "broken windows".<br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div class="gmail_quote"><div> </div><div class="im"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
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.<br></blockquote></div><div><br>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.<br>
</div></div></blockquote><div><br>The main thing I was worried about was whether they were supposed ot be xhtml-strict or xhtml-transitional. <br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="gmail_quote"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">Thoughts? Suggestions?<br></blockquote><div> </div></div>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 :).<br>
<br></blockquote><div><br>It's not "bothering" me per se, and we're agreed that it's not any kind of priority, just thought I might as well try and fix it up while I was looking at it. <br><br>FYI: I've hacked together a simple "lorelint" script to automatically check for these type of issues. Happy to share if anyone thinks it might be useful for future release mgmt automation or whatever.<br>
<br>Kevin Horn<br></div></div>