Skip to content

Conversation

tobiasdiez
Copy link
Contributor

The sage-sws2rst script is used converting old Sage worksheets to ReStructuredText. These Sage worksheets were removed a couple of years ago, so I assume it's fine to delete the conversion script as well. In case someone still has an old notebook lying around, she can use the version from pypi https://pypi.org/project/sage-sws2rst/.

📝 Checklist

  • The title is concise and informative.
  • The description explains in detail what this PR is about.
  • 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

Copy link

github-actions bot commented Jul 2, 2025

Documentation preview for this PR (built with commit 3137b83; changes) is ready! 🎉
This preview will update shortly after each push to this PR.

Copy link
Member

@dimpase dimpase left a comment

Choose a reason for hiding this comment

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

how about mentioning the pypi package to use somewhere in the docs?

@dimpase
Copy link
Member

dimpase commented Jul 2, 2025

How about, instead of deleting src/doc/en/thematic_tutorials/sws2rst.rst, fix it so that it uses the external PyPI package? (I can try this)

@tobiasdiez
Copy link
Contributor Author

tobiasdiez commented Jul 3, 2025

I've now added a short sentence how to deal with these old worksheets - I guess most of the times you would want to convert them to jupter notebooks anyway. Is this sufficient for you?

@dimpase
Copy link
Member

dimpase commented Jul 4, 2025

by right, the thematic tutorial should be moved over to the external package, as something like readthedocs - which I find quite painful to deal with. How about keeping it in for now, with a warning that it's outdated ?
(I think it needs minor editing, explaining how to install it, as this has changed, as well as dropping sage --... in all examples)

@tobiasdiez
Copy link
Contributor Author

This would probably be the 'right' approach - but do you really think anyone cares about this enough for the energy to be invested would be worth it?

@dimpase
Copy link
Member

dimpase commented Jul 6, 2025

In this PR I would settle for keeping the tutorial in, with an added disclaimer that it's outdated.

@tobiasdiez
Copy link
Contributor Author

Okay, done.

Copy link
Member

@dimpase dimpase left a comment

Choose a reason for hiding this comment

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

OK, great. We'll polish it later if need be.

vbraun pushed a commit to vbraun/sage that referenced this pull request Jul 20, 2025
sagemathgh-40360: Remove sage-sws2rst package and related files
    
<!-- ^ 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 sage-sws2rst script is used converting old Sage worksheets to
ReStructuredText. These Sage worksheets were removed a couple of years
ago, so I assume it's fine to delete the conversion script as well. In
case someone still has an old notebook lying around, she can use the
version from pypi https://pypi.org/project/sage-sws2rst/.


### 📝 Checklist

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

- [ ] The title is concise and informative.
- [ ] The description explains in detail what this PR is about.
- [ ] 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#40360
Reported by: Tobias Diez
Reviewer(s): Dima Pasechnik
vbraun pushed a commit to vbraun/sage that referenced this pull request Jul 26, 2025
sagemathgh-40360: Remove sage-sws2rst package and related files
    
<!-- ^ 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 sage-sws2rst script is used converting old Sage worksheets to
ReStructuredText. These Sage worksheets were removed a couple of years
ago, so I assume it's fine to delete the conversion script as well. In
case someone still has an old notebook lying around, she can use the
version from pypi https://pypi.org/project/sage-sws2rst/.


### 📝 Checklist

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

- [ ] The title is concise and informative.
- [ ] The description explains in detail what this PR is about.
- [ ] 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#40360
Reported by: Tobias Diez
Reviewer(s): Dima Pasechnik
vbraun pushed a commit to vbraun/sage that referenced this pull request Jul 26, 2025
sagemathgh-40360: Remove sage-sws2rst package and related files
    
<!-- ^ 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 sage-sws2rst script is used converting old Sage worksheets to
ReStructuredText. These Sage worksheets were removed a couple of years
ago, so I assume it's fine to delete the conversion script as well. In
case someone still has an old notebook lying around, she can use the
version from pypi https://pypi.org/project/sage-sws2rst/.


### 📝 Checklist

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

- [ ] The title is concise and informative.
- [ ] The description explains in detail what this PR is about.
- [ ] 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#40360
Reported by: Tobias Diez
Reviewer(s): Dima Pasechnik
vbraun pushed a commit to vbraun/sage that referenced this pull request Jul 27, 2025
sagemathgh-40360: Remove sage-sws2rst package and related files
    
<!-- ^ 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 sage-sws2rst script is used converting old Sage worksheets to
ReStructuredText. These Sage worksheets were removed a couple of years
ago, so I assume it's fine to delete the conversion script as well. In
case someone still has an old notebook lying around, she can use the
version from pypi https://pypi.org/project/sage-sws2rst/.


### 📝 Checklist

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

- [ ] The title is concise and informative.
- [ ] The description explains in detail what this PR is about.
- [ ] 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#40360
Reported by: Tobias Diez
Reviewer(s): Dima Pasechnik
vbraun pushed a commit to vbraun/sage that referenced this pull request Jul 28, 2025
sagemathgh-40360: Remove sage-sws2rst package and related files
    
<!-- ^ 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 sage-sws2rst script is used converting old Sage worksheets to
ReStructuredText. These Sage worksheets were removed a couple of years
ago, so I assume it's fine to delete the conversion script as well. In
case someone still has an old notebook lying around, she can use the
version from pypi https://pypi.org/project/sage-sws2rst/.


### 📝 Checklist

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

- [ ] The title is concise and informative.
- [ ] The description explains in detail what this PR is about.
- [ ] 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#40360
Reported by: Tobias Diez
Reviewer(s): Dima Pasechnik
vbraun pushed a commit to vbraun/sage that referenced this pull request Jul 29, 2025
sagemathgh-40360: Remove sage-sws2rst package and related files
    
<!-- ^ 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 sage-sws2rst script is used converting old Sage worksheets to
ReStructuredText. These Sage worksheets were removed a couple of years
ago, so I assume it's fine to delete the conversion script as well. In
case someone still has an old notebook lying around, she can use the
version from pypi https://pypi.org/project/sage-sws2rst/.


### 📝 Checklist

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

- [ ] The title is concise and informative.
- [ ] The description explains in detail what this PR is about.
- [ ] 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#40360
Reported by: Tobias Diez
Reviewer(s): Dima Pasechnik
@vbraun vbraun merged commit 6d3bbba into sagemath:develop Aug 2, 2025
22 of 23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants