From owner-freebsd-java Mon Jul 1 5:54:47 2002 Delivered-To: freebsd-java@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 15EE737B400 for ; Mon, 1 Jul 2002 05:54:45 -0700 (PDT) Received: from l04.research.kpn.com (l04.research.kpn.com [139.63.192.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 393B943E09 for ; Mon, 1 Jul 2002 05:54:44 -0700 (PDT) (envelope-from K.J.Koster@kpn.com) Received: by l04.research.kpn.com with Internet Mail Service (5.5.2653.19) id <3B7PJ4RD>; Mon, 1 Jul 2002 14:54:42 +0200 Message-ID: <59063B5B4D98D311BC0D0001FA7E452205FDA7F8@l04.research.kpn.com> From: K.J.Koster@kpn.com To: absinthe@pobox.com, inonit@inonit.com Cc: freebsd-java@FreeBSD.ORG Subject: RE: Docs and bug reporting (was: A Call to Action) Date: Mon, 1 Jul 2002 14:54:42 +0200 MIME-Version: 1.0 X-Mailer: Internet Mail Service (5.5.2653.19) Content-Type: text/plain; charset="iso-8859-1" Sender: owner-freebsd-java@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Dear Dylan, > > (http://www.kjkoster.org/java/) > > Nice site. > Thanks. :) > > User-contributed docs are obviously wonderful when there > isn't anything in the FreeBSD Handbook to speak of. > This is indeed the gap I intended to fill. I considered trying to get my work into freebsd.org's style and shape, but I was just installing my own server and I needed a reason to upgrade to ADSL. :-) > > I would be willing to help out on an effort to take your > documentation as a > base, roll it up to the JDK 1.3 level, and make an effort to > update it with > all the news that is current to the JDK 1.3 patchset. > Please do. > > Finally, we would need to take that and express it in DocBook > markup, and send > it to a committer on the FreeBSD Documentation Project (FDP) > to validate it. > "Finally" being the operative word. While I am all for using the formal process I believe firmly in starting small. I take "small" in this case to mean "start vi (or emacs) and write the text first". If some of the text I (and others and possibly you) wrote is quietly recycled in the FreeBSD documentation project that's fine by me. I'd be happy to ditch my pages once the text is safely in FreeBSD's CVS. However. The core of the problem is lack of time to write the text. Never mind the formatting or which CVS it's in. :) > > It would be useful to get the GNATS maintainer to add a new > category in the database for "java". > Perhaps you could file a PR to this effect? If it isn't permissible I'm sure someone will tell you right away. > > If we can shelter them a little bit from that noise, they > would probably have > more time to code and debug; and it would also create an > environment more suitable for new committers. > We agree on the sheltering part. We agree on the value of the FreeBSD documentation project. I am just worried that you are on your way to do things a tad too well, and that you'll bog down in details and project organisation--type issues. What if you'd get ssh access to my web server, with CVS to my web pages. You could edit my text directly. Easy peasy. :) Kees Jan ===================================================== You can't have everything. Where would you put it? [Steven Wright] To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message