Python docs disappointing

Tim Chase python.list at tim.thechases.com
Fri Jul 31 22:39:31 EDT 2009


Martin P. Hellwig wrote:
> kj wrote:
[excerpt of previously snipped content restored]
>> I'm sure that I can find a full description of this parameter if
>> I fire up Google, and search online.  In fact, more likely than
>> not, I'll find far more documentation than I want.  But my point
>> is that a programmer should not need to do this.  The full
>> documentation should be readily accessible directly through a few
>> keystrokes.
> 
> Well to a level I agree with you.
[snip]
> have an adversity for looking up resources using a web browser

It may not be an adversity for looking things up using a 
web-browser, but rather the need to access documentation offline. 
  Whether on an airplane or simply away from a wifi/landline 
connection, there are plenty of times I'm coding offline (another 
reason I'm happy to have DVCS tools).

This thread prompted me to go digging a little further, and all 
the online docs are available in downloadable format, but you 
have to start by going to the base docs and chasing down the 
"downloads" rabbit-hole.  Perhaps it would be easier if there 
were some sort of back-link from individual pages, referencing 
the downloadable format package.

Combined with the downloaded HTML version of the docs (there are 
PDFs too if you prefer), using a lightweight browser like 
lynx/links/dillo, and optionally adding htdig for local 
search/indexing, you can access (and search) the full docs offline.

-tkc








More information about the Python-list mailing list