[Python-ideas] PEP links in docs

Raymond Hettinger python at rcn.com
Mon Mar 16 23:05:24 CET 2009


> Feel free to send patches, as small as they may seem.  Mark up PEP numbers
> in reST like this -- :pep:`42` -- to get automatic linking.

We might want to include a PEP index in the documentation
but I think it's a really bad idea to include links from within
the docs.  The PEPs get out of date quickly.  They document
an early decision but not its ultimate evolution and diffusion
through-out the language.

Raymond






More information about the Python-ideas mailing list