Return-Path: 
 <derby-dev-return-9357-apmail-db-derby-dev-archive=db.apache.org@db.apache.org>
Delivered-To: apmail-db-derby-dev-archive@www.apache.org
Received: (qmail 42768 invoked from network); 17 Oct 2005 18:34:29 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 17 Oct 2005 18:34:29 -0000
Received: (qmail 64950 invoked by uid 500); 17 Oct 2005 18:34:29 -0000
Delivered-To: apmail-db-derby-dev-archive@db.apache.org
Received: (qmail 64707 invoked by uid 500); 17 Oct 2005 18:34:27 -0000
Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:derby-dev-help@db.apache.org>
List-Unsubscribe: <mailto:derby-dev-unsubscribe@db.apache.org>
List-Post: <mailto:derby-dev@db.apache.org>
List-Id: <derby-dev.db.apache.org>
Delivered-To: mailing list derby-dev@db.apache.org
Received: (qmail 64696 invoked by uid 99); 17 Oct 2005 18:34:27 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 17 Oct 2005 11:34:27 -0700
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received-SPF: neutral (asf.osuosl.org: local policy)
Received: from [32.97.182.143] (HELO e3.ny.us.ibm.com) (32.97.182.143)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 17 Oct 2005 11:34:27 -0700
Received: from d01relay02.pok.ibm.com (d01relay02.pok.ibm.com [9.56.227.234])
	by e3.ny.us.ibm.com (8.12.11/8.12.11) with ESMTP id j9HIY5bS026857
	for <derby-dev@db.apache.org>; Mon, 17 Oct 2005 14:34:05 -0400
Received: from d01av03.pok.ibm.com (d01av03.pok.ibm.com [9.56.224.217])
	by d01relay02.pok.ibm.com (8.12.10/NCO/VERS6.7) with ESMTP id j9HIY5EJ088994
	for <derby-dev@db.apache.org>; Mon, 17 Oct 2005 14:34:05 -0400
Received: from d01av03.pok.ibm.com (loopback [127.0.0.1])
	by d01av03.pok.ibm.com (8.12.11/8.13.3) with ESMTP id j9HIY4xZ027372
	for <derby-dev@db.apache.org>; Mon, 17 Oct 2005 14:34:04 -0400
Received: from [127.0.0.1] (sig-9-48-114-217.mts.ibm.com [9.48.114.217])
	by d01av03.pok.ibm.com (8.12.11/8.12.11) with ESMTP id j9HIXIHZ023625
	for <derby-dev@db.apache.org>; Mon, 17 Oct 2005 14:33:37 -0400
Message-ID: <4353EE65.2050509@debrunners.com>
Date: Mon, 17 Oct 2005 11:33:09 -0700
From: Daniel John Debrunner <djd@debrunners.com>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
 rv:1.7.3) Gecko/20040910
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: derby-dev <derby-dev@db.apache.org>
Subject: Re: [Db-derby Wiki] Update of "SharedComponentVersioningGuidelines"
 by DavidVanCouvering]
References: <435132C7.8060401@sun.com> <015101c5d1aa$86bee4b0$0800a8c0@Arkat>
In-Reply-To: <015101c5d1aa$86bee4b0$0800a8c0@Arkat>
X-Enigmail-Version: 0.90.0.0
X-Enigmail-Supports: pgp-inline, pgp-mime
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N


In the "Documenting Shared Components" in
http://wiki.apache.org/db-derby/SharedComponentVersioningGuidelines
there is this section:

<quote>
We will provide a top-level README file under
java/org/apache/derby/common that describes the shared components
guidelines (once they are approved) and lists the available components.
</quote>

I would suggest a minor change to not have a README file, but instead
use package.html which will then tie into the javadoc (or more generally
ensure it is documented so that it appears as part of the javadoc).

Dan.