I've been looking over the xhtml documents used to generate the twisted documentation, and I'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 <html> 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 <title> element and their <h1> element...this is not the case<br>
<br>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><br>Thoughts? Suggestions?<br><br>I'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>