Skip to content

Add a new confv3 with astropy-unified theme - #94

Merged
astrofrog merged 7 commits into
astropy:mainfrom
Cadair:confv3-again
Apr 14, 2026
Merged

astrofrog merged 7 commits into
astropy:mainfrom
Cadair:confv3-again

Conversation

@Cadair

@Cadair Cadair commented Jan 21, 2026 •

Copy link
Copy Markdown
Member

What's our Python and Sphinx version compatibility policy here? We are running some very old sphinx!

@pllim pllim left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think generally we want to support old versions as much as possible because downstream package using this might not have resources to constantly update. A lot of them got sphinx-astropy dependency from our old astropy package template.

As long as @bsipocz is happy with the bumps, I am too.

Thanks!

Comment thread tox.ini
extras =
tests
v2deps: confv2
v3deps: confv3

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Should add v3deps in env list above?

@bsipocz bsipocz left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm not against dropping old python/sphinx versions, but given this is a low level infra package we should not go too crazy with it.

If it were me, I would drop at EOL and bump to the versions that added support for the next oldest version.
If there is a feature that you want to/need to use then dropping the old versions should be fine, but I don't think we should do that just for the sake of dropping. Not a strongly held opinion, so do let me know if you have arguments besides 1-2 fewer CI jobs.

OTOH, changes here look good, I commit the two fixes that are needed, the rest can go in when you all see fit.

Comment thread pyproject.toml
description = "Sphinx extensions and configuration specific to the Astropy project"
readme = {file = "README.rst", content-type = "text/x-rst"}
requires-python = ">=3.9"
requires-python = ">=3.10"

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Yes, I think we should keep this and only from EOL. But it's not a strong preference as most packages doesn't really need the ability to build docs on their oldest supported version.

python-version: "3.13"
toxenv: py313-test-v2deps-sphinxdev
python-version: "3.14"
toxenv: py314-test-v2deps-sphinxdev

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

please do add a v3 devdeps/sphinxdev job, too. Right now they are the same I think, but that may change.

Comment thread tox.ini Resolved
Comment thread tox.ini Resolved
@Cadair
Cadair marked this pull request as ready for review April 14, 2026 11:05
@Cadair

Cadair commented Apr 14, 2026

Copy link
Copy Markdown
Member Author

ok, I think this is ready to go and would unblock rolling this theme out to all the coordinated packages.

@astrofrog
astrofrog merged commit 2b83ea6 into astropy:main Apr 14, 2026
15 checks passed
@Cadair
Cadair deleted the confv3-again branch April 14, 2026 14:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants