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

Reply via email to