[SciPy-dev] Scipy Tutorial (and updating it)
Thu Dec 4 04:15:31 CST 2008
On Thu, 4 Dec 2008 10:39:44 +0100
Gael Varoquaux <firstname.lastname@example.org> wrote:
> On Thu, Dec 04, 2008 at 10:25:36AM +0100, R. Bastian wrote:
> > > I think the tutorial would be much more usable if it were broken up
> > > into different pages (each as a separate .rst file).
> > No !
> > It's only easier for those not needing a tutorial ;-)
> I don't agree. Long HTML pages are bad practice, every web designer will
> tell you that (http://webstyleguide.com/page/length.html,
> - 10 ...).
Not every webdesigner ...
> The good rule should be: one subject by pages, pages a few screen long
I think (or hope) that's easy to get two forms: a long and single page,
or a lot of small subject centered pages.
In a single page it is easy to read with PageDown, PageUp
and it is easy to search with Ctrl-F.
Different pages are the best choice for treating the subjets, but
a tutorial _is_ a subject. Anyway, everyone can choice
the prefered form.
> If you want a long document, you need the pdf. That's why we use Sphinx.
> Scipy-dev mailing list
More information about the Scipy-dev