Date: Mon, 19 Aug 2002 04:48:58 -0700 From: Bill Huey (Hui) <billh@gnuppy.monkey.org> To: Dylan Carlson <absinthe@pobox.com> Cc: freebsd-java@FreeBSD.ORG, "Bill Huey (Hui)" <billh@gnuppy.monkey.org> Subject: Re: Please review: new Java Project docs Message-ID: <20020819114858.GA2491@gnuppy.monkey.org> In-Reply-To: <200208170958.14422.absinthe@pobox.com> References: <200208170958.14422.absinthe@pobox.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Aug 17, 2002 at 09:58:14AM -0400, Dylan Carlson wrote: > I have finished a 1st-pass at rewriting the FreeBSD Java Project documentation > into DocBook/SGML source format. I have transformed the preview version into > HTML. I would like volunteers to do basic fact-checking and give me their > opinions on where the docs can use improvement. I'll have to check that out sometime in the near future, since DocBook is taking over the world apparently. > Specifically, contributions are needed in the following areas, in order of > importance: > > 1. Adding items to the FAQ (I know I missed some). > > 2. Filling out the "Known Issues" portion of the Release Info sections ... I > know there are open issues currently. > > 3. Authors for the following articles: > 3a. Basics of setting up a Java environment > 3b. Basics of running and troubleshooting Java applications > 3c. Benchmarks (ones that we can legally publish) If you'd like for me to write up more extensive HotSpot build instructions I'll do so. My notes are rather scattered, but I can summarize what I know about each compiler, etc... and what it means in relation to each other. HotSpot and company (eventually alexey's 1.4) need to be promoted, but I don't know when that's appropriate. We also need to publicize this project so that what has been done is known and FreeBSD's Java abilities aren't lost in the wash of daily BSD news. It's a significant enough project that it deserves it's own track outside of FreeBSD mainly because of the significance of Java and since our group encompasses all the open source BSDs. This might be outside of the scope of what you're doing though. > 4. Artists needed for a logo and other decorations. Primarily, it would be > nice to have a Project logo for the index page. Probably nothing bigger > than 300 x 300, royalty-free. Vector graphics need to be in EPS format, and > bitmaps in PNG. Plus URLs to various port member's home pages... > [ http://home.earthlink.net/~dylancarlson/projects/freebsd/javadoc/ ] My personal preference is to group those elements by version more so than port (Linux emulation, native, etc...), so that I can make a decisions about what to install *after* finding out which versions of the JVM are available under various conditions. It's a more natural way of interacting contextually with that information and would avoid additional navigation. A chart would be a possibly be a good way of representing that so that it's clearer, but is also rather confusing since it displays more information than one would gather at a glance. Somebody will have to figure this out. In that regard, (and the broadness of this group) I like the lay out of Kees's page better than the standard FreeBSD's rather static web page look. There's collapsable top level topics, tree lay out, that allows me to get at the info very quickly of various ends of the technical spectrum. http://www.kjkoster.org/java/index.jsp bill To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020819114858.GA2491>