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

Reply via email to