Re: [Jython-users] Jython documentation

[Ben H. <ben...@fi...>]

Sarwar Raza wrote:

>Would anyone be interested in collaborating on the
>'Jython documentation project' - of course not on the
>scale of the Linux or Python docs, but you get the
>general idea. 
>
>thanks
>-Sarwar
>
Yes I would.  

A starting point would be to host it somewhere. Maybe at jython.org 
makes most sense, or we could create project in sourceforge without too 
much trouble.Or do you prefer another project host?

Then, the next question is what to attempt, both style of documentation 
and coverage?

In terms of content coverage, some ideas:

Fundamentals:
    basic differences between Java and Python
    jython types and their mapping to java, python
    calling java from jython
    calling python from jython
    starting jython interpreter from java
    calling java methods from jython
    handling java exceptions in jython
    discuss jython scripts as java classes
    subclassing java classes in jython + Java reflection
    special jython keywords -> javabeans properties mapping
    String handling in jython vs Java
    dir() in jython
   
Jython software and tools
    using interactive interpreter
    configuration properties
    command line options for tools
    layout & description of installed files
    using jythonc
    using python modules
    using java debuggers
    jython performance considerations

Resources
    jython web site
    Bruce Eckel  - thinking in patterns
    python web site
   

Thats a start.

Regards
Ben


>