Hey Anshum,

Did this get sorted out, or is it still an open-question/blocker for
you?  Is there a JIRA with a release-wizard bug that should be fixed
before our next release?

Best,

Jason

On Wed, Dec 31, 2025 at 1:13 PM Anshum Gupta <[email protected]> wrote:
>
> Actually, 2 steps after the current one it seems like the wizard will
> attempt to generate CHANGELOG.md using logchange generate. I'm guessing
> that will fail and so should the logChangeReleaseStep not have updated the
> CHANGELOG.md to begin with?
>
> On Wed, Dec 31, 2025 at 10:06 AM Anshum Gupta <[email protected]>
> wrote:
>
> > After the logChangeRelease step in the release wizard, it records the
> > creation of the v10.0.0 folder and the deletion of the unreleased one, but
> > doesn't seem to do anything about the CHANGELOG.md that is generated.
> >
> > The subsequent steps then fail as the CHANGELOG.md stays there modified. I
> > was wondering if just committing that change would have an impact on any of
> > the subsequent cherry-picks onto the stable branch (10x). It seems like the
> > wizard is tracking the 2 commits and not the CHANGELOG.md modification.
> > TLDR - is committing the changelog mod sufficient for the release wizard to
> > do the right thing?
> >
> > Jan - Perhaps you've already thought about this?
> >
> > There are more details on Slack (#solr-dev) if anyone needs that to
> > provide an informed response.
> >
> > -Anshum
> >
> > On Tue, Dec 30, 2025 at 12:25 PM Anshum Gupta <[email protected]>
> > wrote:
> >
> >> Should there be multiple changelog files for the same JIRA for
> >> different commits? It doesn't align with our older workflow so I'm not sure
> >> if someone has already thought about it.
> >>
> >> On Tue, Dec 23, 2025 at 7:09 PM Gus Heck <[email protected]> wrote:
> >>
> >>> Just used it for the first time. SUPER smooth despite my entirely
> >>> forgetting this had changed. The error message gives a spiffy message on
> >>> how to generate the initial file, and the file it generates has a link to
> >>> the documentation in a comment. Nice Job.
> >>>
> >>> On Mon, Dec 22, 2025 at 9:07 PM Jan Høydahl <[email protected]>
> >>> wrote:
> >>>
> >>> > See https://logchange.dev/tools/logchange/reference/#yaml-entry-format
> >>> > for reference.
> >>> >
> >>> > The 'issues' key is valid, it will render in the CHANGELOG.md as a #123
> >>> > link, which will make sense when rendered on Github UI.
> >>> > For most of the changelog entries we tend to use 'links', even for
> >>> links
> >>> > to PRs. But both are valid.
> >>> > Could be that we should recommend one or the other. Benefit of "links"
> >>> is
> >>> > that it renders as an actual web link in Markdown, that you can follow
> >>> even
> >>> > if the CHANGES.md is rendered elsewhere. Benefit of 'issues' is that
> >>> it is
> >>> > quick and easy..
> >>> >
> >>> > I see there is a changelog yml placed in a sub folder of unreleased/.
> >>> That
> >>> > is not supported. Other YML with syntax error may need to be fixed
> >>> too...
> >>> >
> >>> > Jan
> >>> >
> >>> > > 22. des. 2025 kl. 21:29 skrev Anshum Gupta <[email protected]>:
> >>> > >
> >>> > > Going through the doc link (
> >>> > > https://github.com/apache/solr/blob/main/dev-docs/changelog.adoc)
> >>> > again, it
> >>> > > seems like 'issues/issue' isn't a valid tag.
> >>> > >
> >>> > > On Mon, Dec 22, 2025 at 3:11 PM Anshum Gupta <[email protected]
> >>> >
> >>> > wrote:
> >>> > >
> >>> > >> While working on the release, I was going through the changelog in
> >>> the
> >>> > >> unreleased folder.
> >>> > >> I see both 'issues' as well as 'links' with JIRA number and url. I
> >>> > assumed
> >>> > >> issues was meant to integrate with Github issues but I'm not sure if
> >>> > that's
> >>> > >> true.
> >>> > >>
> >>> > >> Can Jan or someone who has a better idea confirm what this should
> >>> be as
> >>> > >> we'll need to standardize.
> >>> > >>
> >>> > >> Also, I am running into build failure because of bad tags in the
> >>> > changelog
> >>> > >> entry for issues. Getting confirmation on this will help me fix the
> >>> > build
> >>> > >> issue.
> >>> > >>
> >>> > >> On Thu, Nov 20, 2025 at 9:13 AM David Smiley <[email protected]>
> >>> > wrote:
> >>> > >>
> >>> > >>> Nice!
> >>> > >>>
> >>> > >>> On Thu, Nov 20, 2025 at 3:15 AM Jan Høydahl <[email protected]
> >>> >
> >>> > >>> wrote:
> >>> > >>>
> >>> > >>>> Hi,
> >>> > >>>>
> >>> > >>>> I have made a new Github Workflow that generates logchange yml
> >>> files
> >>> > for
> >>> > >>>> each SolrBot dependency PR.
> >>> > >>>> That means that the changelog travels with the commit, including
> >>> > >>> backports
> >>> > >>>> etc, relieving the release manager
> >>> > >>>> for additional work with adding those in bulk during a release.
> >>> > >>>>
> >>> > >>>> Note that there are still >100 open RenovateBot PRs that still
> >>> don't
> >>> > >>> have
> >>> > >>>> the changelog added. So if you're
> >>> > >>>> about to merge a dependency PR, please first order a rebase or do
> >>> a
> >>> > >>> commit
> >>> > >>>> on the PR, which will then
> >>> > >>>> trigger the GH workflow and add the changelog commit to the PR
> >>> branch.
> >>> > >>>>
> >>> > >>>> @Anshum, this means that for the 10.0 release, where you already
> >>> bulk
> >>> > >>>> added changelog entries, hopefully
> >>> > >>>> all dependency upgrades landing on branch_10_0 will include a
> >>> > changelog.
> >>> > >>>> You should still look out for commits
> >>> > >>>> falling through the cracks.
> >>> > >>>>
> >>> > >>>> Jan
> >>> > >>>>
> >>> > >>>>> 30. okt. 2025 kl. 09:09 skrev Jan Høydahl <[email protected]
> >>> >:
> >>> > >>>>>
> >>> > >>>>> Hi,
> >>> > >>>>>
> >>> > >>>>> The transition to logchange/ folder is now done, and
> >>> solr/CHANGES.txt
> >>> > >>> is
> >>> > >>>> gone.
> >>> > >>>>> In repository root there is a new CHANGELOG.md file which is
> >>> > generated
> >>> > >>>> (Do not edit!)
> >>> > >>>>>
> >>> > >>>>> Jan
> >>> > >>>>>
> >>> > >>>>>> 29. okt. 2025 kl. 08:26 skrev Jan Høydahl <
> >>> [email protected]>:
> >>> > >>>>>>
> >>> > >>>>>> Hi,
> >>> > >>>>>>
> >>> > >>>>>> I'm almost done with the transition, but it's taking some time
> >>> to
> >>> > >>>> consolidate branches etc.
> >>> > >>>>>> Even if CHANGES.txt is not yet gone, please contune adding your
> >>> > >>>> changelogs to the
> >>> > >>>>>> changelog/unreleased folder.
> >>> > >>>>>>
> >>> > >>>>>> Jan
> >>> > >>>>>>
> >>> > >>>>>>> 22. okt. 2025 kl. 20:50 skrev Jan Høydahl <
> >>> [email protected]>:
> >>> > >>>>>>>
> >>> > >>>>>>> Hi everyone,
> >>> > >>>>>>>
> >>> > >>>>>>> We're transitioning to logchange, an automated changelog
> >>> generation
> >>> > >>>> tool.
> >>> > >>>>>>> Starting today, there's a six days transition period where you
> >>> can
> >>> > >>> add
> >>> > >>>> changelog
> >>> > >>>>>>> entries using either the old CHANGES.txt method or the new
> >>> > logchange
> >>> > >>>> workflow.
> >>> > >>>>>>> On Tuesday, October 28th, CHANGES.txt will be removed and the
> >>> new
> >>> > >>>> workflow will
> >>> > >>>>>>> be mandatory across main, branch_10x, branch_10_0, and
> >>> branch_9x.
> >>> > >>>>>>>
> >>> > >>>>>>> Why? The new workflow is more maintainable and reduces merge
> >>> > >>> conflicts
> >>> > >>>> during
> >>> > >>>>>>> active development.
> >>> > >>>>>>>
> >>> > >>>>>>> What does this mean for you? Instead of editing CHANGES.txt,
> >>> you'll
> >>> > >>>> create a small
> >>> > >>>>>>> YAML file in the changelog/unreleased/ directory. The build
> >>> system
> >>> > >>>> will automatically
> >>> > >>>>>>> compile these into /CHANGELOG.md during release. For dev-docs
> >>> on
> >>> > the
> >>> > >>>> new process, see:
> >>> > >>>>>>>
> >>> > >>>>>>>
> >>> https://github.com/apache/solr/blob/main/dev-docs/changelog.adoc
> >>> > >>>>>>>
> >>> > >>>>>>> Questions? Feel free to reply to this thread or ask on Slack.
> >>> > >>>>>>>
> >>> > >>>>>>> Thanks,
> >>> > >>>>>>> David and Jan
> >>> > >>>>>>
> >>> > >>>>>
> >>> > >>>>
> >>> > >>>>
> >>> > >>>>
> >>> ---------------------------------------------------------------------
> >>> > >>>> To unsubscribe, e-mail: [email protected]
> >>> > >>>> For additional commands, e-mail: [email protected]
> >>> > >>>>
> >>> > >>>>
> >>> > >>>
> >>> > >>
> >>> > >>
> >>> > >> --
> >>> > >> Anshum Gupta
> >>> > >>
> >>> > >
> >>> > >
> >>> > > --
> >>> > > Anshum Gupta
> >>> >
> >>> >
> >>>
> >>> --
> >>> http://www.needhamsoftware.com (work)
> >>> https://a.co/d/b2sZLD9 (my fantasy fiction book)
> >>>
> >>
> >>
> >> --
> >> Anshum Gupta
> >>
> >
> >
> > --
> > Anshum Gupta
> >
>
>
> --
> Anshum Gupta

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to