[Python-ideas] Linking Doug's stdlib documentation to our main modules doc.

Nick Coghlan ncoghlan at gmail.com
Sun Mar 20 22:11:05 CET 2011


On Mon, Mar 21, 2011 at 4:18 AM, Alexander Belopolsky
<alexander.belopolsky at gmail.com> wrote:
> The reference manual and PyMOTW are two different works
> targeting different audiences.  PyMOTW is more like a tutorial, trying
> to concisely introduce main features of each module without a claim to
> be comprehensive.   In the reference manual on the other hand we try
> to be complete in feature coverage and economical in illustrative
> examples.

You just summarised *exactly* why a bunch of us want to include it in
the official documentation (by reference, anyway): so people can read
PyMOTW as an introduction, and use the official docs as a reference.

A See Also at the bottom of individual module pages, plus an "External
Resources" link on the front page of the docs (as you suggested) would
cover that nicely (especially with a pydotorg redirector in place to
guarantee link stability).

Cheers,
Nick.

-- 
Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia



More information about the Python-ideas mailing list