[Jython-dev] A new Jython DevGuide

[Jeff A. <ja...@fa...>]

I created a repository in the project space on GitHub that is a clone of 
the CPython devguide: https://github.com/jython/devguide

The idea is to draw on the good work done recently (and still being 
done) by CPython to define process and conventions for working on 
GitHub, which is where, we've noted, we need to move. They've blazed a 
trail we'd be daft not to follow wherever we can, and they have tools. 
In any case, that which is not just process is also largely:

  * Guidelines we refer to already;
  * Advice we should probably follow; and
  * Things mandatory on a PSF project.

I'm hoping this will give us a much clearer reference for contributors, 
for less work than maintaining those sections of the Jython wiki. If you 
visit the CPython core developer part of the wiki it has been reduced to 
link <https://wiki.python.org/moin/CoreDevelopment> into the devguide. I 
suppose ours would go on jython.org eventually?

I'm not sure how this will work: e.g. do we create name_jy.rst 
parallels; can we edit mechanically; and is the Jython version on the 
master branch or another? I've already done some deleting and re-making 
branches. So I'll just try it and find out. At the moment I'm 
classifying chapters on a scale of "irredeemably C-specific" through to 
"just as true for Jython". There are not as many at the latter end as 
I'd hoped.

The first outcome has been a minor contribution to the CPython version: 
to make it build on Windows. This puts me on the contributing end of the 
GitHub-based process as practised, which is a useful experience. I'm 
finding review is very ... active :)

Jeff

-- 
Jeff Allen