Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revert to one release notes file #10639

Merged
merged 5 commits into from
Aug 16, 2023

Conversation

Eric-Arellano
Copy link
Collaborator

We have the 0.44.1/0.25.1 release coming up soon. We decided it makes most sense for those docs to live in the same legacy_release_notes.rst file where we already have 0.44.0/0.25.0 because the versioning is still unusual there and we want the prelude explaining what is going on.

For 0.45.0 in October, we will switch to a new layout where each Qiskit version gets a dedicated HTML page. But it's premature to do that now.

So, this PR restores legacy_release_notes.rst to be release_notes.rst like before. But, it is still a manually generated file to avoid all the complexity from the metapackage we don't need anymore. For the 0.44.1/0.25.1 release, we will manually generate the notes using reno. In 0.45.0, we will go back to using the Reno Sphinx extension.

An added benefit of going back to a single file is we avoid breaking any links to release_notes.html.

@Eric-Arellano Eric-Arellano added documentation Something is not clear or an error documentation stable backport potential The bug might be minimal and/or import enough to be port to stable Changelog: None Do not include in changelog labels Aug 15, 2023
@Eric-Arellano Eric-Arellano requested a review from a team as a code owner August 15, 2023 20:09
@Eric-Arellano
Copy link
Collaborator Author

Cc @mtreinish. You'll want to review this commit-by-commit for useful diffs.

@coveralls
Copy link

Pull Request Test Coverage Report for Build 5871268688

  • 0 of 0 changed or added relevant lines in 0 files are covered.
  • No unchanged relevant lines lost coverage.
  • Overall coverage decreased (-0.03%) to 87.239%

Totals Coverage Status
Change from base Build 5871256166: -0.03%
Covered Lines: 74281
Relevant Lines: 85147

💛 - Coveralls

@qiskit-bot
Copy link
Collaborator

One or more of the the following people are requested to review this:

Copy link
Member

@mtreinish mtreinish left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall this LGTM, I just spotted one small formatting error inline for really old release notes.

docs/release_notes.rst Outdated Show resolved Hide resolved
@mtreinish mtreinish added this to the 0.25.1 milestone Aug 16, 2023
@mtreinish mtreinish added this pull request to the merge queue Aug 16, 2023
Merged via the queue into Qiskit:main with commit 0388d54 Aug 16, 2023
14 checks passed
mergify bot pushed a commit that referenced this pull request Aug 16, 2023
* Delete release_notes.rst

* Rename file

* Rewrite the prelude

* Reduce nesting of headers

* Oops, fix bad headers

(cherry picked from commit 0388d54)
@Eric-Arellano Eric-Arellano deleted the release-notes-rnd2 branch August 16, 2023 20:13
mtreinish added a commit to mtreinish/qiskit-core that referenced this pull request Aug 17, 2023
The change to the release notes organization is only needed for the
stable/0.25 branch longer term. Moving forward we'll have a different
release notes strategy likely using the reno sphinx extension directly.
In the short term this reverts to the previous state prior to Qiskit#10639 as
while Qiskit#10639 was necessary for getting 0.25.1 released it did turn off
our CI coverage testing that release notes would be built. Restoring
this is important so we know from CI whether a change to the release
notes works as part of the docs build.

This reverts commit 0388d54.
github-merge-queue bot pushed a commit that referenced this pull request Aug 17, 2023
* Delete release_notes.rst

* Rename file

* Rewrite the prelude

* Reduce nesting of headers

* Oops, fix bad headers

(cherry picked from commit 0388d54)

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>
github-merge-queue bot pushed a commit that referenced this pull request Sep 1, 2023
* Revert "Revert to one release notes file (#10639)"

The change to the release notes organization is only needed for the
stable/0.25 branch longer term. Moving forward we'll have a different
release notes strategy likely using the reno sphinx extension directly.
In the short term this reverts to the previous state prior to #10639 as
while #10639 was necessary for getting 0.25.1 released it did turn off
our CI coverage testing that release notes would be built. Restoring
this is important so we know from CI whether a change to the release
notes works as part of the docs build.

This reverts commit 0388d54.

* Sync release notes from 0.25.1

* Apply typo fix from #10711
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Changelog: None Do not include in changelog documentation Something is not clear or an error documentation stable backport potential The bug might be minimal and/or import enough to be port to stable
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants