On Tue, Mar 4, 2008 at 1:36 PM, A.M. Kuchling <[EMAIL PROTECTED]> wrote: > 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. Speaking for Jython, this would be extremely helpful for us. Once we get caught up, better docs will become one of our most important priorities I think.
-Frank _______________________________________________ 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
