This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author akuchling
Recipients akuchling, docs@python, eli.bendersky, eric.araujo, ezio.melotti, rhettinger, terry.reedy
Date 2011-11-27.23:55:00
SpamBayes Score 1.3196197e-07
Marked as misclassified No
Message-id <1322438101.35.0.713724350459.issue13443@psf.upfronthosting.co.za>
In-reply-to
Content
Yes, linking to the functional module was to point people to a module that might be useful, even if it's not in the stdlib.  A numeric processing or socket handling HOWTO would also pretty much have to link to non-stdlib sources.  The purpose of documentation is to be useful to the reader, so I think if linking to something external would be reasonably useful, we should do it.

Another motivation for linking was to provide alternative explanations; if the reader finds the Functional HOWTO boring or too superficial or too complicated, maybe an alternative discussion like Mertz's "Text Processing" will fit their brain better.  (At least until those alternative sources become so outdated that they're useless...)
History
Date User Action Args
2011-11-27 23:55:01akuchlingsetrecipients: + akuchling, rhettinger, terry.reedy, ezio.melotti, eric.araujo, eli.bendersky, docs@python
2011-11-27 23:55:01akuchlingsetmessageid: <1322438101.35.0.713724350459.issue13443@psf.upfronthosting.co.za>
2011-11-27 23:55:00akuchlinglinkissue13443 messages
2011-11-27 23:55:00akuchlingcreate