Mailing-List: contact general-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: general@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of luckbr1975@gmail.com designates
 209.85.213.47 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAAS6=7hyd4URDCkO-9ub7z5LeZq12ecCHWNv1ZUzt6ssmJ4W0w@mail.gmail.com>
References: 
 <CAAS6=7hyd4URDCkO-9ub7z5LeZq12ecCHWNv1ZUzt6ssmJ4W0w@mail.gmail.com>
Date: Thu, 26 Jul 2012 20:47:06 -0700
Message-ID: 
 <CAGU5spd68kyPe+=481Ty96QdPk8ObqcX+m4XjrFJcmpy-Pn_0w@mail.gmail.com>
Subject: Re: Universal release docs
From: Luciano Resende <luckbr1975@gmail.com>
To: general@incubator.apache.org
Content-Type: multipart/alternative; boundary=14dae9340fb1e33d5904c5c790c2

--14dae9340fb1e33d5904c5c790c2
Content-Type: text/plain; charset=UTF-8

On Thu, Jul 26, 2012 at 6:53 PM, Marvin Humphrey <marvin@rectangular.com>wrote:

> Greets,
>
> The ASF is technology-neutral:
>
>   http://www.apache.org/foundation/how-it-works.html#incubator
>
>   It must be noted that the incubator (just like the board) does not
> perform
>   filtering on the basis of technical issues. This is because the
> foundation
>   respects and suggests variety of technical approaches.
>
> However, the Incubator's primary release documentation page,
> <http://incubator.apache.org/guides/releasemanagement.html>, is rife with
> technology-specific detail.
>
> The Incubator has plenty of universal concerns regarding release signing,
> license headers, distribution, and so on -- which together are more than
> enough to cover in one document.  Adding content specific to N individual
> programming languages or M downstream distribution channels on a single
> shared
> page does not scale.
>

Are you suggesting to remove things specific to java/jar packaging and/or
distributions specific things like maven details ?


>
> I propose that releasemanagement.html be reserved for information which is
> common to all podlings.
>
> Concretely, I suggest that we establish new pages to offload
> technology-specific passages from releasemanagement.html, starting with
> programming-language-specific pages as needed at
> <http://incubator.apache.org/release-{LANG_NAME}.html>.  The URL is an
> implementation detail, but IMO it is important that we maintain dedicated
> outlets for technology-specific contributions, as otherwise our primary
> page
> will quickly return to its current unmanageable size.
>
>
I believe some of these info is important, and we should at least have a
direct link to the extra pages that you are proposing, otherwise new
podlings might just forget about those pieces.


> Marvin Humphrey
>
>
-- 
Luciano Resende
http://people.apache.org/~lresende
http://twitter.com/lresende1975
http://lresende.blogspot.com/

--14dae9340fb1e33d5904c5c790c2--