We can provide some documentation at the end of the month under the benefits of writing slides for javaOne. We also plan on changing how all classes are defined to the one magical final way. That will not happen until probably after May and it is unlikely that documenting those parts of the internals will be worthwhile until then.
Perhaps we need to start making bugs in our bug database to account for high-level internal design changes. It is a good idea and will keep us a little more honest. We need to actually categorize our architecture (or at least in a direction we want the architecture to move in). Off the top of my head: 1. AST/Parsing 2. Interpreter/Evaluation 3. Class definitions 4. Java integration 5. BSF 6. Main (command-line and initialization) Charlie (anyone else?) have thoughts on high-level categories? I would say that 2 and 3 are likely to have heavy changes in the next year. I am not expecting large changes in the other places unless someone has an epiphany. So once we get the categories of the architecture defined we may make bugs directly or make subcategories and then make bugs. Once we have bugs we can then use comments to reflect design directions and decisions. What do people think? -Tom On Mon, 06 Feb 2006, Zane Rockenbaugh defenestrated me: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > I've done a bit of developer oriented technical writing in the past, so was > planning on sitting down > one weekend and get up some basic documentation on how things work. I've been > waiting for the > structural changes in the VM to fall out before beginning in earnest. > > What would be the best resource to guage what is stable and what is going to > change? Is this > information reflected the bug/RFC database or summarized anywhere in > particular? I've gleaned some > from emails and current website, but haven't sat down to disentangle the > information from the > mailing list. Nor do I particularly want to take that route. > > Regards, > Zane > > Thomas E Enebo wrote: > > On Sat, 04 Feb 2006, Anders Bengtsson defenestrated me: > >>fre 2006-02-03 klockan 10:07 -0600 skrev Thomas E Enebo: > >>> In order to make our project reflect reality a little more I have > >>>culled our developer list. I removed developers who are no longer > >>>subscribed to jruby-devel. If I did this in error, then let me know. > >>>However, if you want to be re-added you should realize that you will > >>>be expected to start actively developing... > >>Hey, I'm still on jruby-devel! Can't claim that I've committed anything > >>in the last year or two though, nor that I'll have the time to do it any > >>time soon. ;) > > > > Whoops. Well let me know when you do have time and I will add you back. > > We decided to do this to try and give a more realistic list of how > > many people are actively developing. > > > > -Tom > > > > -----BEGIN PGP SIGNATURE----- > Version: GnuPG v1.4.0 (GNU/Linux) > Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org > > iD8DBQFD54Jilckj3vs+R00RAmwwAJ43c3uWNGpWF60HN4FSqndqWenu5QCfZaqT > o4LieR+lO/FqSoSZP0L4e9M= > =K+M4 > -----END PGP SIGNATURE----- > > > ------------------------------------------------------- > This SF.net email is sponsored by: Splunk Inc. Do you grep through log files > for problems? Stop! Download the new AJAX search engine that makes > searching your log files as easy as surfing the web. DOWNLOAD SPLUNK! > http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642 > _______________________________________________ > Jruby-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/jruby-devel -- + http://www.tc.umn.edu/~enebo +---- mailto:[EMAIL PROTECTED] ----+ | Thomas E Enebo, Protagonist | "Luck favors the prepared | | | mind." -Louis Pasteur | ------------------------------------------------------- This SF.net email is sponsored by: Splunk Inc. Do you grep through log files for problems? Stop! Download the new AJAX search engine that makes searching your log files as easy as surfing the web. DOWNLOAD SPLUNK! http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642 _______________________________________________ Jruby-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/jruby-devel
