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><br>- some docs do not have a DOCTYPE declaration, I think they should all have one<br>
- of those documents that do have DOCTYPEs, some are using xhmtl-strict, and some are using xhtml-transitional, which is preferred?  I think they should all use the same one<br>- some of the docs are lacking an xml namespace attribute in their root &lt;html&gt; element...I think they should either all have one, or none of them should<br>
- according to: <a href="http://twistedmatrix.com/projects/lore/documentation/howto/lore.html">http://twistedmatrix.com/projects/lore/documentation/howto/lore.html</a><br>  all of the docs should have the same text in both their &lt;title&gt; element and their &lt;h1&gt; element...this is not the case<br>
<br>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><br>Thoughts?  Suggestions?<br><br>I&#39;ve opened a ticket (#4050) at <a href="http://twistedmatrix.com/trac/ticket/4050">http://twistedmatrix.com/trac/ticket/4050</a><br>
Please comment.<br><br>Thanks,<br><br>Kevin Horn<br>