You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@netbeans.apache.org by Neil C Smith <ne...@apache.org> on 2023/01/24 14:38:18 UTC
Better release notes for NB17 - the Highlight label
Hi,
Over the last week, I've noticed a number of end-user comments
critical of the release pages and the inability to pick out key
changes in releases. I think it's a valid point.
Some time ago we added a Highlight label intended for PRs so that
authors and reviewers could point out things for the release team and
the release notes generator to prioritise.
So far, this label has only ever been applied once, and we have
nothing for NB17. If you've authored or reviewed a PR that you think
deserves highlighting, please help us out by adding the label! Also,
feel free to add to add to meta-issues if easier (thinking the PHP
additions?).
https://github.com/apache/netbeans/labels/Highlight
If we can't make this work better for NB17 then I guess we have to
discuss a better approach for NB18+?
Thanks and best wishes,
Neil
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Better release notes for NB17 - the Highlight label
Posted by Neil C Smith <ne...@apache.org>.
On Thu, 26 Jan 2023 at 15:37, Eirik Bakke <eb...@ultorg.com> wrote:
>
> There was a top comment on the "Apache NetBeans 15" HackerNews post some months ago that seems relevant:
>
> "None of the blog that is linked here, Netbeans github page, and the official NetBeans website have a single screenshot of what the application looks like. If you compare that to IntelliJ IDEA's website, it's filled with screenshots accompanying a writeup promoting the feature displayed in the screenshot."
> https://news.ycombinator.com/item?id=32835722
>
> It would be good to address these concerns. But of course, this is all volunteer work for us, so it's up to whoever finds inspiration to make improvements...
Thanks for that. I'd seen a few similar pages, which prompted the
original post.
There's also a link to an Eclipse page on there, which is also much
better than what we currently have.
Best wishes,
Neil
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
RE: Better release notes for NB17 - the Highlight label
Posted by Eirik Bakke <eb...@ultorg.com>.
There was a top comment on the "Apache NetBeans 15" HackerNews post some months ago that seems relevant:
"None of the blog that is linked here, Netbeans github page, and the official NetBeans website have a single screenshot of what the application looks like. If you compare that to IntelliJ IDEA's website, it's filled with screenshots accompanying a writeup promoting the feature displayed in the screenshot."
https://news.ycombinator.com/item?id=32835722
It would be good to address these concerns. But of course, this is all volunteer work for us, so it's up to whoever finds inspiration to make improvements...
-- Eirik
-----Original Message-----
From: Michael Bien <mb...@gmail.com>
Sent: Tuesday, January 24, 2023 3:23 PM
To: dev@netbeans.apache.org; László Kishalmi <la...@gmail.com>
Cc: Eirik Bakke <eb...@ultorg.com>
Subject: Re: Better release notes for NB17 - the Highlight label
where to put it? Should we activate the wiki on github or how does this work?
Would be good to be able to copy&paste github markup from PRs including screenshots without having to rehost anything.
-mbien
On 24.01.23 21:04, László Kishalmi wrote:
> Let's bring the "New and Noteworthy" page back! If we start now we
> might have one ready by the time of the release!
>
> I'd do the Gradle section, I guess my ANTLR work in this release is
> not that interesting for the public.
>
> On Tue, Jan 24, 2023 at 11:29 AM Michael Bien <mb...@gmail.com> wrote:
>
>> I had the same thought. But wasn't sure if that is a good idea since
>> the compact nature of release notes can be a feature in itself.
>>
>> The release highlights (new-and-noteworthy as NB used to call the
>> page) with screenshots and clips is more something for blogs/wikis I believe.
>>
>> -mbien
>>
>>
>> On 24.01.23 20:22, Eirik Bakke wrote:
>>> I think screenshots might help a lot in creating more appealing
>>> Release
>> Notes. Often, screenshots from the PR can be reused. And we can
>> always encourage people to attach screenshots in PRs when relevant.
>>> -- Eirik
>>>
>>> -----Original Message-----
>>> From: Neil C Smith <ne...@apache.org>
>>> Sent: Tuesday, January 24, 2023 11:28 AM
>>> To: Michael Bien <mb...@gmail.com>
>>> Cc: dev@netbeans.apache.org
>>> Subject: Re: Better release notes for NB17 - the Highlight label
>>>
>>> On Tue, 24 Jan 2023 at 16:11, Michael Bien <mb...@gmail.com> wrote:
>>>> We can manually group the changes a bit better in the final release
>>>> notes - just like Laszlo did with the Editor category of NB 16.
>>>> Since its often that multiple PRs when taken together would create
>>>> a noteworthy change.
>>> Agreed! Although this is also how we (OK, mainly Geertjan! :-) )
>> highlight things on the download pages, blog posts, social media posts, etc.
>>> Compare eg. https://netbeans.apache.org/download/nb120/index.html
>>> and
>> https://netbeans.apache.org/download/nb16/
>>> The former was definitely becoming burdensome, but the latter is
>> possibly not enough.
>>>> FlatLAF update PR quietly introduces a new theme (highlight label
>> worthy):
>>>> https://github.com/apache/netbeans/pull/5298
>>> ...
>>>> (some?) PHP 8.2 support - but the PRs are already nicely grouped in
>>>> that category
>>> Good list! :-)
>>>
>>>> but tbh as someone who is often going around and labels PRs, I am
>>>> already glad when they are labeled at all :) I am not really
>>>> thinking about release notes at this point in the dev cycle.
>>> Tell me about it! That's kind of the issue, along with grouping,
>>> where
>> maybe the highlight label is not the right way to do this?
>>> Best wishes,
>>>
>>> Neil
>>>
>>> --------------------------------------------------------------------
>>> - To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: dev-help@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>>
>>>
>>>
>>> --------------------------------------------------------------------
>>> - To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: dev-help@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: dev-help@netbeans.apache.org
>>
>> For further information about the NetBeans mailing lists, visit:
>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>
>>
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Better release notes for NB17 - the Highlight label
Posted by Michael Bien <mb...@gmail.com>.
where to put it? Should we activate the wiki on github or how does this
work?
Would be good to be able to copy&paste github markup from PRs including
screenshots without having to rehost anything.
-mbien
On 24.01.23 21:04, László Kishalmi wrote:
> Let's bring the "New and Noteworthy" page back! If we start now we might
> have one ready by the time of the release!
>
> I'd do the Gradle section, I guess my ANTLR work in this release is not
> that interesting for the public.
>
> On Tue, Jan 24, 2023 at 11:29 AM Michael Bien <mb...@gmail.com> wrote:
>
>> I had the same thought. But wasn't sure if that is a good idea since the
>> compact nature of release notes can be a feature in itself.
>>
>> The release highlights (new-and-noteworthy as NB used to call the page)
>> with screenshots and clips is more something for blogs/wikis I believe.
>>
>> -mbien
>>
>>
>> On 24.01.23 20:22, Eirik Bakke wrote:
>>> I think screenshots might help a lot in creating more appealing Release
>> Notes. Often, screenshots from the PR can be reused. And we can always
>> encourage people to attach screenshots in PRs when relevant.
>>> -- Eirik
>>>
>>> -----Original Message-----
>>> From: Neil C Smith <ne...@apache.org>
>>> Sent: Tuesday, January 24, 2023 11:28 AM
>>> To: Michael Bien <mb...@gmail.com>
>>> Cc: dev@netbeans.apache.org
>>> Subject: Re: Better release notes for NB17 - the Highlight label
>>>
>>> On Tue, 24 Jan 2023 at 16:11, Michael Bien <mb...@gmail.com> wrote:
>>>> We can manually group the changes a bit better in the final release
>>>> notes - just like Laszlo did with the Editor category of NB 16. Since
>>>> its often that multiple PRs when taken together would create a
>>>> noteworthy change.
>>> Agreed! Although this is also how we (OK, mainly Geertjan! :-) )
>> highlight things on the download pages, blog posts, social media posts, etc.
>>> Compare eg. https://netbeans.apache.org/download/nb120/index.html and
>> https://netbeans.apache.org/download/nb16/
>>> The former was definitely becoming burdensome, but the latter is
>> possibly not enough.
>>>> FlatLAF update PR quietly introduces a new theme (highlight label
>> worthy):
>>>> https://github.com/apache/netbeans/pull/5298
>>> ...
>>>> (some?) PHP 8.2 support - but the PRs are already nicely grouped in
>>>> that category
>>> Good list! :-)
>>>
>>>> but tbh as someone who is often going around and labels PRs, I am
>>>> already glad when they are labeled at all :) I am not really thinking
>>>> about release notes at this point in the dev cycle.
>>> Tell me about it! That's kind of the issue, along with grouping, where
>> maybe the highlight label is not the right way to do this?
>>> Best wishes,
>>>
>>> Neil
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: dev-help@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: dev-help@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: dev-help@netbeans.apache.org
>>
>> For further information about the NetBeans mailing lists, visit:
>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>
>>
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Better release notes for NB17 - the Highlight label
Posted by László Kishalmi <la...@gmail.com>.
Let's bring the "New and Noteworthy" page back! If we start now we might
have one ready by the time of the release!
I'd do the Gradle section, I guess my ANTLR work in this release is not
that interesting for the public.
On Tue, Jan 24, 2023 at 11:29 AM Michael Bien <mb...@gmail.com> wrote:
> I had the same thought. But wasn't sure if that is a good idea since the
> compact nature of release notes can be a feature in itself.
>
> The release highlights (new-and-noteworthy as NB used to call the page)
> with screenshots and clips is more something for blogs/wikis I believe.
>
> -mbien
>
>
> On 24.01.23 20:22, Eirik Bakke wrote:
> > I think screenshots might help a lot in creating more appealing Release
> Notes. Often, screenshots from the PR can be reused. And we can always
> encourage people to attach screenshots in PRs when relevant.
> >
> > -- Eirik
> >
> > -----Original Message-----
> > From: Neil C Smith <ne...@apache.org>
> > Sent: Tuesday, January 24, 2023 11:28 AM
> > To: Michael Bien <mb...@gmail.com>
> > Cc: dev@netbeans.apache.org
> > Subject: Re: Better release notes for NB17 - the Highlight label
> >
> > On Tue, 24 Jan 2023 at 16:11, Michael Bien <mb...@gmail.com> wrote:
> >> We can manually group the changes a bit better in the final release
> >> notes - just like Laszlo did with the Editor category of NB 16. Since
> >> its often that multiple PRs when taken together would create a
> >> noteworthy change.
> > Agreed! Although this is also how we (OK, mainly Geertjan! :-) )
> highlight things on the download pages, blog posts, social media posts, etc.
> >
> > Compare eg. https://netbeans.apache.org/download/nb120/index.html and
> https://netbeans.apache.org/download/nb16/
> >
> > The former was definitely becoming burdensome, but the latter is
> possibly not enough.
> >
> >> FlatLAF update PR quietly introduces a new theme (highlight label
> worthy):
> >> https://github.com/apache/netbeans/pull/5298
> > ...
> >> (some?) PHP 8.2 support - but the PRs are already nicely grouped in
> >> that category
> > Good list! :-)
> >
> >> but tbh as someone who is often going around and labels PRs, I am
> >> already glad when they are labeled at all :) I am not really thinking
> >> about release notes at this point in the dev cycle.
> > Tell me about it! That's kind of the issue, along with grouping, where
> maybe the highlight label is not the right way to do this?
> >
> > Best wishes,
> >
> > Neil
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>
Re: Better release notes for NB17 - the Highlight label
Posted by Michael Bien <mb...@gmail.com>.
I had the same thought. But wasn't sure if that is a good idea since the
compact nature of release notes can be a feature in itself.
The release highlights (new-and-noteworthy as NB used to call the page)
with screenshots and clips is more something for blogs/wikis I believe.
-mbien
On 24.01.23 20:22, Eirik Bakke wrote:
> I think screenshots might help a lot in creating more appealing Release Notes. Often, screenshots from the PR can be reused. And we can always encourage people to attach screenshots in PRs when relevant.
>
> -- Eirik
>
> -----Original Message-----
> From: Neil C Smith <ne...@apache.org>
> Sent: Tuesday, January 24, 2023 11:28 AM
> To: Michael Bien <mb...@gmail.com>
> Cc: dev@netbeans.apache.org
> Subject: Re: Better release notes for NB17 - the Highlight label
>
> On Tue, 24 Jan 2023 at 16:11, Michael Bien <mb...@gmail.com> wrote:
>> We can manually group the changes a bit better in the final release
>> notes - just like Laszlo did with the Editor category of NB 16. Since
>> its often that multiple PRs when taken together would create a
>> noteworthy change.
> Agreed! Although this is also how we (OK, mainly Geertjan! :-) ) highlight things on the download pages, blog posts, social media posts, etc.
>
> Compare eg. https://netbeans.apache.org/download/nb120/index.html and https://netbeans.apache.org/download/nb16/
>
> The former was definitely becoming burdensome, but the latter is possibly not enough.
>
>> FlatLAF update PR quietly introduces a new theme (highlight label worthy):
>> https://github.com/apache/netbeans/pull/5298
> ...
>> (some?) PHP 8.2 support - but the PRs are already nicely grouped in
>> that category
> Good list! :-)
>
>> but tbh as someone who is often going around and labels PRs, I am
>> already glad when they are labeled at all :) I am not really thinking
>> about release notes at this point in the dev cycle.
> Tell me about it! That's kind of the issue, along with grouping, where maybe the highlight label is not the right way to do this?
>
> Best wishes,
>
> Neil
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
RE: Better release notes for NB17 - the Highlight label
Posted by Eirik Bakke <eb...@ultorg.com>.
I think screenshots might help a lot in creating more appealing Release Notes. Often, screenshots from the PR can be reused. And we can always encourage people to attach screenshots in PRs when relevant.
-- Eirik
-----Original Message-----
From: Neil C Smith <ne...@apache.org>
Sent: Tuesday, January 24, 2023 11:28 AM
To: Michael Bien <mb...@gmail.com>
Cc: dev@netbeans.apache.org
Subject: Re: Better release notes for NB17 - the Highlight label
On Tue, 24 Jan 2023 at 16:11, Michael Bien <mb...@gmail.com> wrote:
> We can manually group the changes a bit better in the final release
> notes - just like Laszlo did with the Editor category of NB 16. Since
> its often that multiple PRs when taken together would create a
> noteworthy change.
Agreed! Although this is also how we (OK, mainly Geertjan! :-) ) highlight things on the download pages, blog posts, social media posts, etc.
Compare eg. https://netbeans.apache.org/download/nb120/index.html and https://netbeans.apache.org/download/nb16/
The former was definitely becoming burdensome, but the latter is possibly not enough.
> FlatLAF update PR quietly introduces a new theme (highlight label worthy):
> https://github.com/apache/netbeans/pull/5298
...
> (some?) PHP 8.2 support - but the PRs are already nicely grouped in
> that category
Good list! :-)
> but tbh as someone who is often going around and labels PRs, I am
> already glad when they are labeled at all :) I am not really thinking
> about release notes at this point in the dev cycle.
Tell me about it! That's kind of the issue, along with grouping, where maybe the highlight label is not the right way to do this?
Best wishes,
Neil
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Better release notes for NB17 - the Highlight label
Posted by Neil C Smith <ne...@apache.org>.
On Tue, 24 Jan 2023 at 16:11, Michael Bien <mb...@gmail.com> wrote:
> We can manually group the changes a bit better in the final release
> notes - just like Laszlo did with the Editor category of NB 16. Since
> its often that multiple PRs when taken together would create a
> noteworthy change.
Agreed! Although this is also how we (OK, mainly Geertjan! :-) )
highlight things on the download pages, blog posts, social media
posts, etc.
Compare eg. https://netbeans.apache.org/download/nb120/index.html and
https://netbeans.apache.org/download/nb16/
The former was definitely becoming burdensome, but the latter is
possibly not enough.
> FlatLAF update PR quietly introduces a new theme (highlight label worthy):
> https://github.com/apache/netbeans/pull/5298
...
> (some?) PHP 8.2 support - but the PRs are already nicely grouped in that
> category
Good list! :-)
> but tbh as someone who is often going around and labels PRs, I am
> already glad when they are labeled at all :)
> I am not really thinking about release notes at this point in the dev cycle.
Tell me about it! That's kind of the issue, along with grouping,
where maybe the highlight label is not the right way to do this?
Best wishes,
Neil
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Better release notes for NB17 - the Highlight label
Posted by Michael Bien <mb...@gmail.com>.
We can manually group the changes a bit better in the final release
notes - just like Laszlo did with the Editor category of NB 16. Since
its often that multiple PRs when taken together would create a
noteworthy change.
FlatLAF update PR quietly introduces a new theme (highlight label worthy):
https://github.com/apache/netbeans/pull/5298
Close whole documents list at once (by first time contributor):
https://github.com/apache/netbeans/pull/4792
Many fixes and updates in the Jakarta EE field. Some of them we could
manually move from the Java category to Enterprise.
Gradle 8 support + updates - Laszlo would know best what to highlight
Maven 3.8.7 bundled, better stacktrace handling in the output window,
mvnd output window fixes + basic dependency updater hint
(some?) PHP 8.2 support - but the PRs are already nicely grouped in that
category
...
but tbh as someone who is often going around and labels PRs, I am
already glad when they are labeled at all :)
I am not really thinking about release notes at this point in the dev cycle.
-mbien
On 24.01.23 15:38, Neil C Smith wrote:
> Hi,
>
> Over the last week, I've noticed a number of end-user comments
> critical of the release pages and the inability to pick out key
> changes in releases. I think it's a valid point.
>
> Some time ago we added a Highlight label intended for PRs so that
> authors and reviewers could point out things for the release team and
> the release notes generator to prioritise.
>
> So far, this label has only ever been applied once, and we have
> nothing for NB17. If you've authored or reviewed a PR that you think
> deserves highlighting, please help us out by adding the label! Also,
> feel free to add to add to meta-issues if easier (thinking the PHP
> additions?).
>
> https://github.com/apache/netbeans/labels/Highlight
>
> If we can't make this work better for NB17 then I guess we have to
> discuss a better approach for NB18+?
>
> Thanks and best wishes,
>
> Neil
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists