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

Remove Qiskit 0.45 and 0.46 release notes from 1.0 #11840

Merged
merged 2 commits into from
Feb 22, 2024

Conversation

Eric-Arellano
Copy link
Collaborator

Closes #11835. We decided in the dev meeting that the simplest fix is to have each stable branch solely have release notes for its own minor version.

@Eric-Arellano Eric-Arellano requested a review from a team as a code owner February 20, 2024 16:44
@qiskit-bot
Copy link
Collaborator

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

@mtreinish
Copy link
Member

Do we need to update this on main too?

@mtreinish mtreinish added this to the 1.0.1 milestone Feb 21, 2024
@jakelishman jakelishman added this pull request to the merge queue Feb 22, 2024
Merged via the queue into Qiskit:stable/1.0 with commit a3b91e6 Feb 22, 2024
10 of 11 checks passed
@Eric-Arellano Eric-Arellano deleted the EA/release-notes-1.0 branch February 22, 2024 18:00
github-merge-queue bot pushed a commit to Qiskit/documentation that referenced this pull request Feb 23, 2024
…#860)

### Summary 

Part of #755

This PR changes the logic of the API generation script to only modify
the release notes file of the version we are regenerating at that
moment. Before, the release notes files contained more than one version,
and we needed to update several files, independently of what version we
were regenerating. After Qiskit/qiskit#11840, we
can assume that the release notes files will only contain their own
versions, and we can simply our script by removing some functions.

### New logic

The API generation script will transform every link of the release notes
files to point to its version folder instead of the top level. Once we
have the correct links, we will directly write the release notes file,
if we didn't have them before, or otherwise, we will create a new file
containing the header of the old file we had and the version sections of
the new one downloaded from Box. That way, we can make manual changes
like the table added in the release notes of qiskit 0.44 without losing
them in the next regeneration.

### Functions removed

This change allows us to remove the following two functions:

The `extractMarkdownReleaseNotesPatches` function extracted all the
versions in a release notes file and stored the markdown of each patch
to posteriorly merge them under their minor version file. Now we have
one minor version per file, so we don't need to break the release notes
into pieces anymore. The new logic treats all patch versions as a block.

The `sortReleaseNotesVersions` were used to sort the patch versions.
Given that the file will have the correct order, we don't need to worry
about it either.

Removing these two functions allows us to remove the test file, given
that they composed the entire file.
frankharkins pushed a commit to frankharkins/documentation that referenced this pull request Jul 22, 2024
…Qiskit#860)

### Summary 

Part of Qiskit#755

This PR changes the logic of the API generation script to only modify
the release notes file of the version we are regenerating at that
moment. Before, the release notes files contained more than one version,
and we needed to update several files, independently of what version we
were regenerating. After Qiskit/qiskit#11840, we
can assume that the release notes files will only contain their own
versions, and we can simply our script by removing some functions.

### New logic

The API generation script will transform every link of the release notes
files to point to its version folder instead of the top level. Once we
have the correct links, we will directly write the release notes file,
if we didn't have them before, or otherwise, we will create a new file
containing the header of the old file we had and the version sections of
the new one downloaded from Box. That way, we can make manual changes
like the table added in the release notes of qiskit 0.44 without losing
them in the next regeneration.

### Functions removed

This change allows us to remove the following two functions:

The `extractMarkdownReleaseNotesPatches` function extracted all the
versions in a release notes file and stored the markdown of each patch
to posteriorly merge them under their minor version file. Now we have
one minor version per file, so we don't need to break the release notes
into pieces anymore. The new logic treats all patch versions as a block.

The `sortReleaseNotesVersions` were used to sort the patch versions.
Given that the file will have the correct order, we don't need to worry
about it either.

Removing these two functions allows us to remove the test file, given
that they composed the entire file.
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
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants