From owner-freebsd-java@FreeBSD.ORG  Thu Apr  1 10:45:27 2004
Return-Path: <owner-freebsd-java@FreeBSD.ORG>
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 8B30816A4CE; Thu,  1 Apr 2004 10:45:27 -0800 (PST)
Received: from svbcf02.win.tue.nl (svbcf02.win.tue.nl [131.155.71.100])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id EEB1143D48; Thu,  1 Apr 2004 10:45:26 -0800 (PST)
	(envelope-from mriem@win.tue.nl)
Received: from SENSEI (v175.vpn.tue.nl [131.155.212.175])
	by svbcf02.win.tue.nl (Postfix) with ESMTP
	id 52DB18C6C; Thu,  1 Apr 2004 20:45:25 +0200 (MET DST)
From: "Manfred Riem" <mriem@win.tue.nl>
To: <freebsd-java@freebsd.org>, <freebsd-doc@freebsd.org>
Date: Thu, 1 Apr 2004 20:45:22 +0200
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook, Build 11.0.5510
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1165
Thread-Index: AcQYGXzwB82XZN8nTBqhgvnTe43uWQ==
Message-Id: <20040401184525.52DB18C6C@svbcf02.win.tue.nl>
cc: mriem@win.tue.nl
Subject: Documentation proposal
X-BeenThere: freebsd-java@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Porting Java to FreeBSD <freebsd-java.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-java>,
	<mailto:freebsd-java-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-java>
List-Post: <mailto:freebsd-java@freebsd.org>
List-Help: <mailto:freebsd-java-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-java>,
	<mailto:freebsd-java-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 01 Apr 2004 18:45:27 -0000

Hi there,

I want to try to make the Java documentation on the FreeBSD website
a bit more usable. Currently the bits are a bit scattered around.

I propose to have following changes for the main page:

 - Moving "How can I help?" to the section called "Documentation".

 - Moving "I found a bug?" to the section called "Documentation".

 - Removing "Performance Comparison" as it is dated December 1999.

 - Adding a section called "Screenshots" to "Documentation".

 - Removing "Creating Ports" as currently not a real standard has
   been set. Follow up on the discussion recently held on the 
   mailinglist.

 - Rolling up "Java Resources" into a page called "Links" and 
   putting it into section "Documentation"

 - Moving "Tutorials" content from "Documentation" into "Links".


Am I right to assume the documentation is available on the CVS server,
so should I just go ahead and do the proposed changes myself and send
you guys the result?


And also some other thoughts:

 - Separate subdirectories for the releases 1.1, 1.2, 1.3 and 1.4
  
 - A more clear definition for newbies on how to install Java from
   the sources (eg. tell them about the linux bootstrap).


Regards,

Manfred Riem
mriem@win.tue.nl
http://www.riaca.win.tue.nl/