[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