[SciPy-dev] Scipy Tutorial (and updating it)

R. Bastian rbastian@free...
Thu Dec 4 04:15:31 CST 2008


On Thu, 4 Dec 2008 10:39:44 +0100
Gael Varoquaux <gael.varoquaux@normalesup.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,
> http://www.astrodigital.org/digital/shortvslongpages.html,
> http://www.webpagesthatsuck.com/biggest-mistakes-in-web-design-1995-2015.html
> - 10 ...).

Not every webdesigner ...

> 
> The good rule should be: one subject by pages, pages a few screen long
> maximum.

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.
> 
> Gaël
> _______________________________________________
> Scipy-dev mailing list
> Scipy-dev@scipy.org
> http://projects.scipy.org/mailman/listinfo/scipy-dev
> 


-- 
R. Bastian 
www.musiques-rb.org



More information about the Scipy-dev mailing list