[docs] [issue4819] Misc/cheatsheet needs updating

Éric Araujo report at bugs.python.org
Wed Jul 13 17:01:21 CEST 2011


Éric Araujo <merwok at netwok.org> added the comment:

I spent a few minutes updating the cheatsheet.  I think that the document is an outdated duplicate of random parts of the docs (syntax, man page, library reference, etc.) that’s rather hard to maintain for little benefit.  Is there any evidence that people used it?

I’d like to propose that we delete the file in 2.7 (it’s already gone from 3.2+) and that we start anew on a real cheatsheet, i.e. one or two A4 pages, in HTML and PDF and t-shirts, which are a useful summary of commonly used things.  I think one Python language cheatsheet and one standard library cheatsheet could be useful (one set for 2.7, another one for 3.2).

Regarding process, I’m not sure using a wiki or a non-reST file not included in the real docs is the way to go.  Maybe volunteers could work with the PSF team that’s producing a brochure?  (http://brochure.getpython.info/ —I discovered it recently, and don’t know at all who works on it and how)

----------
versions:  -Python 3.1

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue4819>
_______________________________________


More information about the docs mailing list