[Live-demo] RC4 Build and Docs Styles

Alex Mandel tech_dev at wildintellect.com
Mon Jul 26 17:53:15 EDT 2010


Wondering if I should wait a few hours before starting the next build
(rc4 seems to be what people want to call it).

Right now I'm trying to tackle the styling and linking of the sphinx
generated html. I'm somewhat confused as to why some links are
autoreplaced and others not (R specifically, probably a name mismatch)
and why a Quickstart link is on the contents page but not an explicit
link for the Description. Yes the name links but I don't think that's
clear to the end user that they probably want to read the full
description before the Quickstart.

Also, any reason we aren't use the TOC feature of Sphinx for the whole
help section? The link to the top of the documentation in the overviews
goes to a sphinx generated copy of the home which lacks any links to get
elsewhere, and the index is just blank.

I assume as I dig into sphinx I'll find some of these answers, but if
someone already knows, please feel free to enlighten me.

Thanks,
Alex


More information about the Live-demo mailing list