Re: Apache POI 3.15 released

[Dominik Stadler]

Hi,

thanks for this work, I think having the notable-change-items also in the
status.xml is a good thing because it is easier to remember what changes
did happen at the time the changelog is updated compared to when the
release is prepared later by one dev who might not be aware that somebody
else did build something a while back.

Dominik.

On Fri, Oct 21, 2016 at 12:23 PM, Javen O'Neal  wrote:

> I added the major changes from the 3.15 release notes [1] to the
> detailed changelog [2] in r1765977 [3].
>
> [1] https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
> [2] https://poi.apache.org/changes.html
> [3] https://svn.apache.org/viewvc?view=revision=1765977
>
> We could choose to update the changelog with the major changes when we
> announce a release, create the "RELEASE-NOTES-.txt" as Nick
> suggested, or both.
> If we decide that it's a headache maintaining the major changes in two
> locations and prefer going with "RELEASE-NOTES-.txt", then
> we can revert the changes I made to status.xml
>
> In the meantime, what's the best way to retrieve old release notes?
> Were they committed to a private or public SVN server? If not, we can
> dig through the dev@ email archive for the [VOTE] email, but this
> would take longer to extract.
>
> On Thu, Sep 29, 2016 at 3:08 PM, Nick Burch  wrote:
> > On 29/09/16 15:29, Javen O'Neal wrote:
> >>
> >> Do we archive the release notes somewhere so that someone can read a
> >> high-level summary of the changes for each release? Digging through
> >> the dev@ email list archive to find the release notes draft or
> >> searching a web archiver of one of the mirrors at a date in the past
> >> seem suboptimal. There is no release notes file in the subversion tag
> >> or a page on our site that summarizes the changes in a release more
> >> concisely than changes.html.
> >>
> >> The current https://poi.apache.org links to both 3.14 and 3.15, but we
> >> overwrote the 3.14 release notes on
> >> https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
> >> and all mirrors when we released 3.15.
> >
> >
> > After a final release, the homepage and download page should only ever
> link
> > to the most current final version. No other versions should live on the
> dist
> > area, otherwise infra get grumpy...
> >
> > When we do an alpha or beta release, then homepage + download should
> link to
> > both
> >
> > If we don't already, it might be good to deploy the release notes twice,
> > once as "RELEASE-NOTES.txt" (overwritten often), once as
> > "RELEASE-NOTES-.txt". The latter would then always be
> available
> > from archive.apache.org even after a newer final release. Thoughts?
> >
> > Nick
> >
> >
> >
> > -
> > To unsubscribe, e-mail: dev-unsubscr...@poi.apache.org
> > For additional commands, e-mail: dev-h...@poi.apache.org
> >
>
> -
> To unsubscribe, e-mail: dev-unsubscr...@poi.apache.org
> For additional commands, e-mail: dev-h...@poi.apache.org
>
>

Re: Apache POI 3.15 released

[Nick Burch]

On Fri, 21 Oct 2016, Javen O'Neal wrote:

In the meantime, what's the best way to retrieve old release notes?
Were they committed to a private or public SVN server?


We've been using svnpubsub for dist for a while (2011 IIRC), so you ought 
to be able to get them from there by asking SVN for the release notes file 
at older revision numbers


(Shout if you can't do that easily, and I can try to script something up)

Nick

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

Re: Apache POI 3.15 released

[Javen O'Neal]

I added the major changes from the 3.15 release notes [1] to the
detailed changelog [2] in r1765977 [3].

[1] https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
[2] https://poi.apache.org/changes.html
[3] https://svn.apache.org/viewvc?view=revision=1765977

We could choose to update the changelog with the major changes when we
announce a release, create the "RELEASE-NOTES-.txt" as Nick
suggested, or both.
If we decide that it's a headache maintaining the major changes in two
locations and prefer going with "RELEASE-NOTES-.txt", then
we can revert the changes I made to status.xml

In the meantime, what's the best way to retrieve old release notes?
Were they committed to a private or public SVN server? If not, we can
dig through the dev@ email archive for the [VOTE] email, but this
would take longer to extract.

On Thu, Sep 29, 2016 at 3:08 PM, Nick Burch  wrote:
> On 29/09/16 15:29, Javen O'Neal wrote:
>>
>> Do we archive the release notes somewhere so that someone can read a
>> high-level summary of the changes for each release? Digging through
>> the dev@ email list archive to find the release notes draft or
>> searching a web archiver of one of the mirrors at a date in the past
>> seem suboptimal. There is no release notes file in the subversion tag
>> or a page on our site that summarizes the changes in a release more
>> concisely than changes.html.
>>
>> The current https://poi.apache.org links to both 3.14 and 3.15, but we
>> overwrote the 3.14 release notes on
>> https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
>> and all mirrors when we released 3.15.
>
>
> After a final release, the homepage and download page should only ever link
> to the most current final version. No other versions should live on the dist
> area, otherwise infra get grumpy...
>
> When we do an alpha or beta release, then homepage + download should link to
> both
>
> If we don't already, it might be good to deploy the release notes twice,
> once as "RELEASE-NOTES.txt" (overwritten often), once as
> "RELEASE-NOTES-.txt". The latter would then always be available
> from archive.apache.org even after a newer final release. Thoughts?
>
> Nick
>
>
>
> -
> To unsubscribe, e-mail: dev-unsubscr...@poi.apache.org
> For additional commands, e-mail: dev-h...@poi.apache.org
>

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

Re: Apache POI 3.15 released

[David North]

Sorry, I was aware of that - fixing it fell off my radar. Apologies.

On 29/09/16 15:19, Javen O'Neal wrote:
> Nevermind. Just need to update the POI homepage to link to release
> instead of dev.
> 
> On Thu, Sep 29, 2016 at 4:13 PM, Javen O'Neal  wrote:
>> The release notes have not made it to the apache and non-apache
>> mirrors. The release notes reference "3.15-beta 2" for me. Did the
>> 3.15 final release notes get published correctly?
>>
>> https://www.apache.org/dyn/closer.lua/poi/dev/RELEASE-NOTES.txt
>>
>> On Thu, Sep 22, 2016 at 7:34 PM, Javen O'Neal  wrote:
>>> Good point!
>>>
>>> A one sentence "Apache POI is a Java library for reading and writing
>>> Microsoft Office files" should do. We'll add this to our announce template
>>> for future releases.
>>>
>>>
>>> On Sep 22, 2016 9:28 AM, "sebb"  wrote:

 What is the project about? Why should I be interested in it?
 [rhetorical questions]

 The Announce emails are sent to people not on the developer or user lists.
 Most will have no idea what the project is about.

 So the e-mails should contain at least brief details of what the
 product does, and some info on why the new release might be of
 interest to them.

 Readers should not have to click the link to find out the basic
 information
 (although of course it is useful to have such links for further detail).

 Please can you add that information to future announce mails?

 Thanks.

 On 21 September 2016 at 23:32, David North  wrote:
> The Apache POI PMC are pleased to announce the release of Apache POI
> 3.15.
>
> For details of changes in this release, refer to the release notes:
>
> https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
>
> Thank you to all our contributors for making this release possible.
>
> Some of us will be at ApacheCon Europe in Seville later in the year; do
> find us there if you have input and suggestions.
>
> On behalf of the Apache POI PMC,
>
> David North

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

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

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

Re: Apache POI 3.15 released

[Nick Burch]

On 29/09/16 15:29, Javen O'Neal wrote:

Do we archive the release notes somewhere so that someone can read a
high-level summary of the changes for each release? Digging through
the dev@ email list archive to find the release notes draft or
searching a web archiver of one of the mirrors at a date in the past
seem suboptimal. There is no release notes file in the subversion tag
or a page on our site that summarizes the changes in a release more
concisely than changes.html.

The current https://poi.apache.org links to both 3.14 and 3.15, but we
overwrote the 3.14 release notes on
https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
and all mirrors when we released 3.15.


After a final release, the homepage and download page should only ever 
link to the most current final version. No other versions should live on 
the dist area, otherwise infra get grumpy...


When we do an alpha or beta release, then homepage + download should 
link to both


If we don't already, it might be good to deploy the release notes twice, 
once as "RELEASE-NOTES.txt" (overwritten often), once as 
"RELEASE-NOTES-.txt". The latter would then always be 
available from archive.apache.org even after a newer final release. 
Thoughts?


Nick


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

Re: Apache POI 3.15 released

[Javen O'Neal]

Do we archive the release notes somewhere so that someone can read a
high-level summary of the changes for each release? Digging through
the dev@ email list archive to find the release notes draft or
searching a web archiver of one of the mirrors at a date in the past
seem suboptimal. There is no release notes file in the subversion tag
or a page on our site that summarizes the changes in a release more
concisely than changes.html.

The current https://poi.apache.org links to both 3.14 and 3.15, but we
overwrote the 3.14 release notes on
https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
and all mirrors when we released 3.15.

On Thu, Sep 29, 2016 at 4:19 PM, Javen O'Neal  wrote:
> Nevermind. Just need to update the POI homepage to link to release
> instead of dev.
>
> On Thu, Sep 29, 2016 at 4:13 PM, Javen O'Neal  wrote:
>> The release notes have not made it to the apache and non-apache
>> mirrors. The release notes reference "3.15-beta 2" for me. Did the
>> 3.15 final release notes get published correctly?
>>
>> https://www.apache.org/dyn/closer.lua/poi/dev/RELEASE-NOTES.txt
>>
>> On Thu, Sep 22, 2016 at 7:34 PM, Javen O'Neal  wrote:
>>> Good point!
>>>
>>> A one sentence "Apache POI is a Java library for reading and writing
>>> Microsoft Office files" should do. We'll add this to our announce template
>>> for future releases.
>>>
>>>
>>> On Sep 22, 2016 9:28 AM, "sebb"  wrote:

 What is the project about? Why should I be interested in it?
 [rhetorical questions]

 The Announce emails are sent to people not on the developer or user lists.
 Most will have no idea what the project is about.

 So the e-mails should contain at least brief details of what the
 product does, and some info on why the new release might be of
 interest to them.

 Readers should not have to click the link to find out the basic
 information
 (although of course it is useful to have such links for further detail).

 Please can you add that information to future announce mails?

 Thanks.

 On 21 September 2016 at 23:32, David North  wrote:
 > The Apache POI PMC are pleased to announce the release of Apache POI
 > 3.15.
 >
 > For details of changes in this release, refer to the release notes:
 >
 > https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
 >
 > Thank you to all our contributors for making this release possible.
 >
 > Some of us will be at ApacheCon Europe in Seville later in the year; do
 > find us there if you have input and suggestions.
 >
 > On behalf of the Apache POI PMC,
 >
 > David North

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

>>>

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

Re: Apache POI 3.15 released

[Javen O'Neal]

Nevermind. Just need to update the POI homepage to link to release
instead of dev.

On Thu, Sep 29, 2016 at 4:13 PM, Javen O'Neal  wrote:
> The release notes have not made it to the apache and non-apache
> mirrors. The release notes reference "3.15-beta 2" for me. Did the
> 3.15 final release notes get published correctly?
>
> https://www.apache.org/dyn/closer.lua/poi/dev/RELEASE-NOTES.txt
>
> On Thu, Sep 22, 2016 at 7:34 PM, Javen O'Neal  wrote:
>> Good point!
>>
>> A one sentence "Apache POI is a Java library for reading and writing
>> Microsoft Office files" should do. We'll add this to our announce template
>> for future releases.
>>
>>
>> On Sep 22, 2016 9:28 AM, "sebb"  wrote:
>>>
>>> What is the project about? Why should I be interested in it?
>>> [rhetorical questions]
>>>
>>> The Announce emails are sent to people not on the developer or user lists.
>>> Most will have no idea what the project is about.
>>>
>>> So the e-mails should contain at least brief details of what the
>>> product does, and some info on why the new release might be of
>>> interest to them.
>>>
>>> Readers should not have to click the link to find out the basic
>>> information
>>> (although of course it is useful to have such links for further detail).
>>>
>>> Please can you add that information to future announce mails?
>>>
>>> Thanks.
>>>
>>> On 21 September 2016 at 23:32, David North  wrote:
>>> > The Apache POI PMC are pleased to announce the release of Apache POI
>>> > 3.15.
>>> >
>>> > For details of changes in this release, refer to the release notes:
>>> >
>>> > https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
>>> >
>>> > Thank you to all our contributors for making this release possible.
>>> >
>>> > Some of us will be at ApacheCon Europe in Seville later in the year; do
>>> > find us there if you have input and suggestions.
>>> >
>>> > On behalf of the Apache POI PMC,
>>> >
>>> > David North
>>>
>>> -
>>> To unsubscribe, e-mail: dev-unsubscr...@poi.apache.org
>>> For additional commands, e-mail: dev-h...@poi.apache.org
>>>
>>

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

Re: Apache POI 3.15 released

[Javen O'Neal]

The release notes have not made it to the apache and non-apache
mirrors. The release notes reference "3.15-beta 2" for me. Did the
3.15 final release notes get published correctly?

https://www.apache.org/dyn/closer.lua/poi/dev/RELEASE-NOTES.txt

On Thu, Sep 22, 2016 at 7:34 PM, Javen O'Neal  wrote:
> Good point!
>
> A one sentence "Apache POI is a Java library for reading and writing
> Microsoft Office files" should do. We'll add this to our announce template
> for future releases.
>
>
> On Sep 22, 2016 9:28 AM, "sebb"  wrote:
>>
>> What is the project about? Why should I be interested in it?
>> [rhetorical questions]
>>
>> The Announce emails are sent to people not on the developer or user lists.
>> Most will have no idea what the project is about.
>>
>> So the e-mails should contain at least brief details of what the
>> product does, and some info on why the new release might be of
>> interest to them.
>>
>> Readers should not have to click the link to find out the basic
>> information
>> (although of course it is useful to have such links for further detail).
>>
>> Please can you add that information to future announce mails?
>>
>> Thanks.
>>
>> On 21 September 2016 at 23:32, David North  wrote:
>> > The Apache POI PMC are pleased to announce the release of Apache POI
>> > 3.15.
>> >
>> > For details of changes in this release, refer to the release notes:
>> >
>> > https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
>> >
>> > Thank you to all our contributors for making this release possible.
>> >
>> > Some of us will be at ApacheCon Europe in Seville later in the year; do
>> > find us there if you have input and suggestions.
>> >
>> > On behalf of the Apache POI PMC,
>> >
>> > David North
>>
>> -
>> To unsubscribe, e-mail: dev-unsubscr...@poi.apache.org
>> For additional commands, e-mail: dev-h...@poi.apache.org
>>
>

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

Re: Apache POI 3.15 released

[Javen O'Neal]

Good point!

A one sentence "Apache POI is a Java library for reading and writing
Microsoft Office files" should do. We'll add this to our announce template
for future releases.

On Sep 22, 2016 9:28 AM, "sebb"  wrote:

> What is the project about? Why should I be interested in it?
> [rhetorical questions]
>
> The Announce emails are sent to people not on the developer or user lists.
> Most will have no idea what the project is about.
>
> So the e-mails should contain at least brief details of what the
> product does, and some info on why the new release might be of
> interest to them.
>
> Readers should not have to click the link to find out the basic information
> (although of course it is useful to have such links for further detail).
>
> Please can you add that information to future announce mails?
>
> Thanks.
>
> On 21 September 2016 at 23:32, David North  wrote:
> > The Apache POI PMC are pleased to announce the release of Apache POI
> 3.15.
> >
> > For details of changes in this release, refer to the release notes:
> >
> > https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
> >
> > Thank you to all our contributors for making this release possible.
> >
> > Some of us will be at ApacheCon Europe in Seville later in the year; do
> > find us there if you have input and suggestions.
> >
> > On behalf of the Apache POI PMC,
> >
> > David North
>
> -
> To unsubscribe, e-mail: dev-unsubscr...@poi.apache.org
> For additional commands, e-mail: dev-h...@poi.apache.org
>
>

Re: Apache POI 3.15 released

[sebb]

What is the project about? Why should I be interested in it?
[rhetorical questions]

The Announce emails are sent to people not on the developer or user lists.
Most will have no idea what the project is about.

So the e-mails should contain at least brief details of what the
product does, and some info on why the new release might be of
interest to them.

Readers should not have to click the link to find out the basic information
(although of course it is useful to have such links for further detail).

Please can you add that information to future announce mails?

Thanks.

On 21 September 2016 at 23:32, David North  wrote:
> The Apache POI PMC are pleased to announce the release of Apache POI 3.15.
>
> For details of changes in this release, refer to the release notes:
>
> https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt
>
> Thank you to all our contributors for making this release possible.
>
> Some of us will be at ApacheCon Europe in Seville later in the year; do
> find us there if you have input and suggestions.
>
> On behalf of the Apache POI PMC,
>
> David North

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

Apache POI 3.15 released

[David North]

The Apache POI PMC are pleased to announce the release of Apache POI 3.15.

For details of changes in this release, refer to the release notes:

https://www.apache.org/dyn/closer.lua/poi/release/RELEASE-NOTES.txt

Thank you to all our contributors for making this release possible.

Some of us will be at ApacheCon Europe in Seville later in the year; do
find us there if you have input and suggestions.

On behalf of the Apache POI PMC,

David North

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