[SciPy-dev] Scipy Tutorial (and updating it)
R. Bastian
rbastian at free.fr
Thu Dec 4 05:15:31 EST 2008
On Thu, 4 Dec 2008 10:39:44 +0100
Gael Varoquaux <gael.varoquaux at 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 at scipy.org
> http://projects.scipy.org/mailman/listinfo/scipy-dev
>
--
R. Bastian
www.musiques-rb.org
More information about the SciPy-Dev
mailing list