<div class="gmail_quote">On Mon, Oct 5, 2009 at 1:25 PM, Glyph Lefkowitz <span dir="ltr">&lt;<a href="mailto:glyph@twistedmatrix.com">glyph@twistedmatrix.com</a>&gt;</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">&lt;<a href="mailto:kevin.horn@gmail.com" target="_blank">kevin.horn@gmail.com</a>&gt;</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&#39;ve been looking over the xhtml documents used to generate the twisted documentation, and I&#39;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&#39;m playing around with some automated processing of these documents (mostly as an exercise to learn lxml), and I&#39;m having to work around some of these things.  And since I was thinking about it anyway, I thought I&#39;d take the opportunity to fix up some &quot;broken windows&quot;.<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&#39;m planning to correct some of these issues, but I wanted to get others&#39; 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&#39;t define its own attributes, on purpose: it uses existing XHTML facilities like &quot;class&quot; 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&#39;m sure we&#39;d be happy to accept some patches to clean these documents up, especially if it&#39;s bothering you, but it seems pretty low-priority to me :).<br>

<br></blockquote><div><br>It&#39;s not &quot;bothering&quot; me per se, and we&#39;re agreed that it&#39;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&#39;ve hacked together a simple &quot;lorelint&quot; 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>