classification
Title: tutorial links at top, book recommendations at bottom of module documentation
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.5, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, georg.brandl, python-dev, vy0123
Priority: normal Keywords:

Created on 2014-10-27 01:03 by vy0123, last changed 2014-10-28 21:19 by python-dev. This issue is now closed.

Messages (4)
msg230052 - (view) Author: Van Ly (vy0123) * Date: 2014-10-27 01:03
IMO the box highlight at the top of module documentation, for example, re module (library/re.html#module-re), ought to place book recommendations at the very bottom in a section called 'Further Readings'. Why? Because being at the top of the documentation should mean it is instantly accessible. 

The box highlight of tutorials at the top is a nice touch.
msg230128 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2014-10-28 08:25
I agree, the "see also" box is better off near the bottom, probably before the examples.
msg230175 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014-10-28 20:42
New changeset 4ad8b11ca309 by Georg Brandl in branch '3.4':
Closes #22736: move seealso to the bottom of the section about RE syntax.
https://hg.python.org/cpython/rev/4ad8b11ca309
msg230177 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014-10-28 21:19
New changeset 465892bb0c12 by Georg Brandl in branch '2.7':
Closes #22736: move seealso to the bottom of the section about RE syntax.
https://hg.python.org/cpython/rev/465892bb0c12
History
Date User Action Args
2014-10-28 21:19:32python-devsetmessages: + msg230177
2014-10-28 20:42:20python-devsetstatus: open -> closed

nosy: + python-dev
messages: + msg230175

resolution: fixed
stage: resolved
2014-10-28 08:25:29georg.brandlsetnosy: + georg.brandl
messages: + msg230128
2014-10-27 01:03:42vy0123create