On 18/02/2014 16:35, Gary Gregory wrote:
> On Tue, Feb 18, 2014 at 4:19 AM, Mark Thomas <ma...@apache.org> wrote:
> 
>> On 18/02/2014 05:26, Gary Gregory wrote:
>>> Problem with the site: on the main page under "Migrating from Pool 2.0",
>>> the current version described is 2.1, not 2.2.
>>>
>>> I would rename this section "Migrating to Pool 2.1 from 2.0" and add a
>> new
>>> section "Migrating to Pool 2.2 from 2.1". The "Migrating from Pool 1.x"
>>> section should then be renamed "Migrating to Pool 2.0 from 1.x". This
>> will
>>> give migrations a clearer set of docs IMO.
>>
>> Yes, that needs some work. I'll take a look.
>>
>> I'd prefer it if this page didn't need to be updated with every release
>> as that adds to the work required for each release as well as adding
>> another place where something can be overlooked requiring a new RC.
>>
> 
> The page only has to be updated if the user has to migrate anything. If a
> release is 100% source and binary compatible, you do not have to say
> anything.

The way the page was structured it needed to be updated for every
release. I agree it should only need changing if there are migration
issues to mention (which there shouldn't be). The new wording should
address that.

> IMO, it would be better to say something, but that's just me,
> hopefully the site has a like to the RN file so I can look there.

It has a link to the changes file but not the release notes. The site
building process doesn't appear to copy the release notes else I could
just add a link.

Mark


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org

Reply via email to