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

Migrate old Sage release tours and changelogs from Sage website and wiki to GitHub Releases or Sage documentation #31533

Open
mkoeppe opened this issue Mar 21, 2021 · 27 comments

Comments

@mkoeppe
Copy link
Member

mkoeppe commented Mar 21, 2021

Following the practices of many other projects, we make old release notes (release tours; but not changelogs) part of the normal documentation available on the GitHub Releases.

This is one more step to getting rid of the wiki.

Related: #31415 GH Actions workflow that deploys built documentation

CC: @slel

Component: documentation

Issue created by migration from https://trac.sagemath.org/ticket/31533

@mkoeppe mkoeppe added this to the sage-9.4 milestone Mar 21, 2021
@mkoeppe mkoeppe modified the milestones: sage-9.4, sage-9.5 Jul 19, 2021
@mkoeppe mkoeppe modified the milestones: sage-9.5, sage-9.6 Dec 14, 2021
@mkoeppe mkoeppe modified the milestones: sage-9.6, sage-9.7 Apr 2, 2022
@mkoeppe mkoeppe modified the milestones: sage-9.7, sage-9.8 Aug 31, 2022
@mkoeppe mkoeppe modified the milestones: sage-9.8, sage-9.9 Jan 7, 2023
@mkoeppe mkoeppe removed this from the sage-10.0 milestone Apr 30, 2023
@mkoeppe mkoeppe changed the title Migrate old Sage release tours from Sage wiki to Sage documentation Migrate old Sage release tours and changelogs from Sage website and wiki to Sage documentation May 21, 2023
@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 17, 2024

Migrated the list https://wiki.sagemath.org/ReleaseTours to GitHub Releases.

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 18, 2024

Suggested to upload old release tarballs to GitHub Releases - https://groups.google.com/g/sage-devel/c/GYKHtknK-CA/m/od9nVkoHAQAJ

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 18, 2024

Next:

@mkoeppe mkoeppe changed the title Migrate old Sage release tours and changelogs from Sage website and wiki to Sage documentation Migrate old Sage release tours and changelogs from Sage website and wiki to GitHub Releases or Sage documentation Aug 18, 2024
@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

@kwankyu re your post https://groups.google.com/g/sage-devel/c/GYKHtknK-CA/m/2Y2R2ElCAQAJ, I have done most of the above already for all releases < 4.0

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

OK. Nice!

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

not yet migrated: Image attachments.

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

You migrated release notes to github Releases. Does that also support image attachments?

@mkoeppe

This comment was marked as outdated.

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

I deleted the fully migrated pages from https://wiki.sagemath.org/TitleIndex#idx-R and emptied those that have image attachments

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

The oldest is 2.10.4. Is that the oldest version that has release notes?

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

I deleted the fully migrated pages from https://wiki.sagemath.org/TitleIndex#idx-R and emptied those that have image attachments

Do you mean "do not have image attachements"? For example, https://wiki.sagemath.org/ReleaseTours/sage-4.1.1?action=show&redirect=sage-4.1.1 is still there.

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

I haven't touched anything for >= 4.0 yet.

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

Ah right.

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

The oldest is 2.10.4. Is that the oldest version that has release notes?

Oldest is actually 2.10.1, but 2.10.4 is displayed below it for an unknown reason.

Yes, I have created releases for all tags that either had individual release notes or changelog files. I had this full list already in https://wiki.sagemath.org/ReleaseTours (now gutted)

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

What is your plan with releases < 2.10.1?

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

No immediate plan to do anything. My priority was to migrate stuff away from the Sage wiki

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

The sage release tarballs from the "old files" site are available. Do you plan to upload them to github Releases?

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

I can't seem to access http://old.files.sagemath.org/src-old/; any help with the uploading is welcome

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

It is working now. I thought somebody booted it up responding to you...

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

No, doesn't work for me. Strange

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

Anyway I may upload them, one by one slowly starting from the oldest stable version. I don't know any use of them, but perhaps just for completeness...

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

I don't know any use of them

Neither do I; it just serves archival purposes

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

I've completed the migration for the release tours for Sage <= 9.0 now, as well as 9.2 and 9.4.
Unfortunately https://github.com/sagemath/sagewiki_to_gh-2022-10-10/tree/master/ReleaseTours does not have the release tours for 9.1, 9.3, 9.5, probably because of a bug in the conversion script (https://github.com/sagemath/sagewiki-to-github).
So these will have to be taken directly from https://wiki.sagemath.org/TitleIndex#idx-R, or the script fixed and re-run.

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

You migrated release notes to github Releases. Does that also support image attachments?

Yes, I just added one to test it. See https://github.com/sagemath/sage/releases/tag/2.11

Update: Migrated all images now.

Update: 9.1, 9.3, 9.5 have been migrated with the help of https://github.com/phlash/moin2markdown

The migration of release notes from the Sage wiki is now complete.

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

I have troubles in releasing sage 0.1.

A. I want to attach only the old tarball. But after release, there are added one Source zip and one Source tar file automatically.
B. The release 0.1 appears before 10.4. I want it to be the last one.

@kwankyu
Copy link
Collaborator

kwankyu commented Aug 19, 2024

Perhaps (A) is related with the commit to which the tag 0.1 is attached. As there is no commit that can be associated with the tag 0.1, it seems inappropriate to push these pre-git releases to github "Releases"....

@mkoeppe
Copy link
Member Author

mkoeppe commented Aug 19, 2024

I agree. Let's skip old releases that do not correspond to an existing tag in the repository.

vbraun pushed a commit to vbraun/sage that referenced this issue Sep 5, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
vbraun pushed a commit to vbraun/sage that referenced this issue Sep 6, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
vbraun pushed a commit to vbraun/sage that referenced this issue Sep 8, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
vbraun pushed a commit to vbraun/sage that referenced this issue Sep 8, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
vbraun pushed a commit to vbraun/sage that referenced this issue Sep 10, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
vbraun pushed a commit to vbraun/sage that referenced this issue Sep 12, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
vbraun pushed a commit to vbraun/sage that referenced this issue Sep 14, 2024
… tours links

    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

The release tours are now accessed through GitHub Releases.

This is the next step of:
- sagemath#31533

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#38581
Reported by: Matthias Köppe
Reviewer(s): Kwankyu Lee
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants