[Python-Dev] Re: Stability and change
Tue, 28 May 2002 17:50:00 +0200
Guido van Rossum wrote:
>>Exactly. The changes _are_ documented in detail, indeed, but in
>>special documents which only serious users read when they about to
>>migrate from one version to another. I'm thinking about users who
>>use the language occasionally or even regularly, but not fanatic
>>about following everything about versions -- they mainly rely on the
>>Python Library Reference, or even the Python Language Reference.
> Hm. People who don't read the detailed documents shouldn't expect to
> rely on details.
People do read the detailed documents, but not again and again
every 6-8 months... heck, I work in the Python development team
and don't even feel like I am up-to-date with all the changes
going on in the core. If not even developers can follow the
rate of change, how should a typical Python user feel ?
Conclusion: I think that we need a migration guide for Python.
This would solve a whole lot of these "rate of change" problems.
The guide should complement the additions and changes to the other
documentation and provide a single source of knowledge in that
Currently, the only source we have in this area is the
Misc/NEWS file and this doesn't provide any upgrade path
hints or porting details.
CEO eGenix.com Software GmbH
Company & Consulting: http://www.egenix.com/
Python Software: http://www.egenix.com/files/python/
Meet us at EuroPython 2002: http://www.europython.org/