On Tue, Mar 04, 2008 at 08:58:57AM -0500, Steve Holden wrote: > While I hesitate to suggest a change of such magnitude, there's > something to recommend the old IBM mainframe approach of separating out > "Principles of Operation" (which would be the reference manuals, in > Python's case the Language and Library refs) from "Users' Guide" which > contains the practical stuff you need to actually make use of a product.
Good suggestion. Using the debugger and profiler could also be covered in the User's Guide. Would splitting up the docs make them more useful for IronPython/Jython? For example, Jython could eventually take the 2.6 language docs as-is, but modify the library reference to remove unsupported modules and add Jython-specific ones. --amk _______________________________________________ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com