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

7.0.0 release plan #11358

Closed
AA-Turner opened this issue Apr 26, 2023 · 11 comments
Closed

7.0.0 release plan #11358

AA-Turner opened this issue Apr 26, 2023 · 11 comments
Assignees

Comments

@AA-Turner
Copy link
Member

I intend to release Sphinx 7 this weekend (though I'm open to arguments to delay).

This release would be only removing expired deprecations, with new features to go in to 7.1.0, to be released around June. I think generally making releases smaller (in terms of delta from the previous release) and slightly more frequent would help debugging -- e.g. in #11354 it was quite hard to pin-point exactly what caused the issue, and crude bisecting of released versions is a useful debug tool.

A

cc: @sphinx-doc/developers

@AA-Turner AA-Turner self-assigned this Apr 26, 2023
@AA-Turner AA-Turner pinned this issue Apr 26, 2023
@benjaoming
Copy link
Contributor

@AA-Turner is there a way to list which removals that will take place?

@AA-Turner
Copy link
Member Author

Yep, will be updating CHANGES as usual. If you want the list ahead of time, the majority are enumerated in https://www.sphinx-doc.org/en/master/extdev/deprecated.html (look for a 7.0 removal version).

A

@AA-Turner
Copy link
Member Author

The most notable removal for Sphinx 7 is likely support for HTML 4.

@benjaoming
Copy link
Contributor

Thanks @AA-Turner 🙏

@benjaoming
Copy link
Contributor

For testing convenience, could you put up a 7.0b1 release or similar? 🙏

@benjaoming
Copy link
Contributor

I might release 7.0rc1, but previously we've had very little feedback on pre-releases.

I remember that 6.0b1 was out very early, which was highly appreciated. This was very helpful since there was some time to build support for the jQuery removal. From a Read the Docs perspective, it's nice to be able to test out a PyPi release in a few build processes. We do get back some attention from users that either haven't pinned an upper bound on Sphinx or simply want the latest version.

If you do a pre-release that works, I will send you back more than crickets ❤️

From a theme/extension perspective, I think it can mean that whoever prioritizes it can bump the Sphinx version dependencies early on. But I guess most maintainers will wait for the stable release before making this effort.

@AA-Turner
Copy link
Member Author

Sounds good -- I will try and release 7.0rc1 this afternoon (UK time).

A

@AA-Turner
Copy link
Member Author

Sphinx 7.0.0rc1 has been released.

A

cc: @benjaoming

@AA-Turner
Copy link
Member Author

Sphinx 7.0.0 has been released. Thanks to all for your contributions.

A

@benjaoming
Copy link
Contributor

I did just manage to get a 7.0.0rc1 build up on RTD that indicates that we have something working 👍 https://test-builds.readthedocs.io/en/sphinx-7.0.x/

@AA-Turner AA-Turner unpinned this issue May 2, 2023
@github-actions github-actions bot locked as resolved and limited conversation to collaborators May 31, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

2 participants