<div class="gmail_quote">On Fri, Feb 5, 2010 at 1:00 PM, Terry Jones <span dir="ltr"><<a href="mailto:terry@jon.es">terry@jon.es</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;">
Hi Kevin<br>
<br>
I think this is looking really good. Here are a few superficial / quick<br>
comments.<br>
<br>
- It looks fine under Google chrome<br></blockquote><div><br>Good to hear!<br><br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
- You could reduce visual repetition / density of some of the high-level<br>
pages by taking out a word like "Documentation" which appears in the<br>
heading and on every line of things like this:<br>
<br>
Twisted Documentation Table of Contents<br>
Twisted Conch Documentation<br>
Twisted Core Documentation<br>
Historical Documents<br>
Twisted Lore Documentation<br>
Twisted Mail Documentation<br>
Twisted Names Documentation<br>
Twisted Pair Documentation<br>
Twisted VFS Documentation<br>
Twisted Web Documentation<br>
Twisted Web2 Documentation<br>
Twisted Words Documentation<br>
<br>
See also <a href="http://twistedsphinx.funsize.net/contents.html" target="_blank">http://twistedsphinx.funsize.net/contents.html</a> which is very<br>
cluttered with repeated content.<br>
<br>
I realize these are probably just being picked up out of the .rst header<br>
line, and that one of those documents when seen in isolation probably<br>
should have a full title. I'm not sure how best to simplify the<br>
top-level, though I guess it's possible to extend the sphinx layout.html<br>
and override something... may be more trouble than it's worth.<br></blockquote><div><br>A lot of this is because the auto-generated TOC is being shown, and it is indeed picking up the document titles out of the source file it happens to be pointing to. In the final version, I'm thinking we won't really need to show the toctrees at all, since most of the docs have index files already (which I'm generating the toctree directives from), so most of this will "fix itself".<br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
- I think it would improve appearance a little to have a non-intrusive<br>
border around the green source code boxes.<br></blockquote><div><br>Not a bad idea. Or maybe an "outline" instead of a "border"?<br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
I'll see if I can find/make time to have a look at the CSS.<br></blockquote><div><br>That would be really great. There are a few things that are driving me bonkers. For example: the prev/next/index links on the right hand side of the gray navbar are 1 freakin' pixel lower than the "breadcrumb" links on the left hand side of the same navbar () at least on this machine), and I have no idea why.<br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Terry<br>
<br>
_______________________________________________<br>
Twisted-Python mailing list<br>
<a href="mailto:Twisted-Python@twistedmatrix.com">Twisted-Python@twistedmatrix.com</a><br>
<a href="http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python" target="_blank">http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python</a><br>
</blockquote></div><br>