Online documentation split onto many small pages

Peter Otten __peter__ at web.de
Sat Aug 25 08:49:05 CEST 2007


Ben Finney wrote:

> Grant Edwards <grante at visi.com> writes:
> 
>> I don't really understand what the advantage for splitting up
>> documentation into screen-sized chunks is supposed to be -- all the
>> web browsers I've ever seen can scroll.
> 
> The issue is the time to download the page. Most of the world does not
> have fast internet access.
> 
>> One page per module or chapter sure would make it easier to
>> search...
> 
> Fortunately online documentation in multiple HTML pages is indexable
> by the major search engines; most of those can search within one
> domain, or even within one path prefix of a domain.

The new and improved layout uses fewer pages, but indeed feels less snappy.
See for yourself:

http://docs.python.org/dev/distutils/setupscript.html
http://docs.python.org/dist/setup-script.html

Peter
 




More information about the Python-list mailing list