[Twisted-Python] Task-based documentation started

Albert Brandl albert.brandl at weiermayer.com
Tue Feb 1 07:52:49 MST 2011


On Tue, Feb 01, 2011 at 09:05:32AM -0500, Tom Davis wrote:
>     The "breadcrumbs" on the main page look like this:
>     "Contents   ::   Serving on the Web   HTML, CGI, WSGI, etc.    "
>     Might be a problem with the Sphinx configuration.
> 
> Yeah, this is just how the Sphinx template lays things out and it's the 
> default one I use for documentation on my site, merely because the 
> color scheme is similar. It's definitely not the greatest and a 
> Twisted-theme one already exists so we'll be working from that.

I was talking about the _content_ of the breadcrumbs. The main page
should not contain the "Serving on the Web..." breadcrumb IMO.

> These are ToC trees which are different from inline links. I don't feel 
> there's much harm in linking to something twice on one page especially 
> when the same words are used and one of the uses is clearly a ToC.

Maybe the title of the section should be renamed, then.

> Thanks for the feedback!

You're welcome!

Albert
-- 
Albert Brandl
Weiermayer Solutions GmbH      | Abteistraße 12, A-4813 Altmünster
phone: +43 (0) 720 70 30 14    | fax: +43 (0) 7612 20 3 56
web: http://www.weiermayer.com




More information about the Twisted-Python mailing list