On Tue, Mar 4, 2008 at 1:36 PM, A.M. Kuchling <amk at amk.ca> 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
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4