Feature Requests item #1232073, was opened at 2005-07-04 03:28 Message generated for change (Comment added) made by rhettinger You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=355470&aid=1232073&group_id=5470
Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: Documentation Group: None Status: Open Resolution: None Priority: 5 Submitted By: Michael Hoffman (hoffmanm) Assigned to: Nobody/Anonymous (nobody) Summary: Links to tutorials and howtos from references Initial Comment: I see many people on comp.lang.python who are frustrated by the existing documentation, which is written at an advanced level for total beginners. It might aid in discoverability of the tutorial and howtos if more "See also" links were placed in language and library reference pages. For example: <http://docs.python.org/lib/module-re.html> could link to <http://www.amk.ca/python/howto/regex/>. This would probably reduce the number of basic re questions on c.l.p and tutor, and make it easier to learn the language and stdlib. I'll submit my own patches as I have time. ---------------------------------------------------------------------- >Comment By: Raymond Hettinger (rhettinger) Date: 2005-07-13 16:57 Message: Logged In: YES user_id=80475 -1 The reference docs need to remain loosely coupled or decoupled from the how-tos and tutorial. Links in the other direction are okay (the beginner's guides and overviews may reference the detailed docs). If you're interested in submitting docs patches, it would be nice to get the how-to guides up-to-date. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=355470&aid=1232073&group_id=5470 _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com