-
Notifications
You must be signed in to change notification settings - Fork 19
docs: Upgrade Sphinx and change copyright year to "2022-%Y" #1118
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
Conversation
|
What happened to the checks on this PR? I'm waiting until we get a passing PR to review. |
I think GitHub was having some problems on Friday. I saw checks hanging in other repos too. |
|
Closing and reopening to try to fix GitHub checks |
61a8575 to
5518f74
Compare
The checks are passing now (despite Poetry+virtualenv |
* service: Reformat pyproject.toml * service: Upgrade to latest Sphinx * service: Update poetry.lock * service: Update copyright to reflect year first published * service: Add a comment about Sphinx version * docs: Add gRPC and protobuf hyperlinks * service: Update poetry.lock (cherry picked from commit 64174c6)
* service: Reformat pyproject.toml * service: Upgrade to latest Sphinx * service: Update poetry.lock * service: Update copyright to reflect year first published * service: Add a comment about Sphinx version * docs: Add gRPC and protobuf hyperlinks * service: Update poetry.lock (cherry picked from commit 64174c6)
* docs: Upgrade Sphinx and change copyright year to "2022-%Y" (#1118) * service: Reformat pyproject.toml * service: Upgrade to latest Sphinx * service: Update poetry.lock * service: Update copyright to reflect year first published * service: Add a comment about Sphinx version * docs: Add gRPC and protobuf hyperlinks * service: Update poetry.lock (cherry picked from commit 64174c6) * docs: Remove Sphinx --keep-going option (#1126) (cherry picked from commit 262ab18) * docs: Remove tomlkit dependency (#1166) * docs: Remove tomlkit dependency * service: Update poetry.lock (cherry picked from commit 15b1bb8)
What does this Pull Request accomplish?
Upgrade to the latest Sphinx, which requires Python 3.11 or later.
Change copyright year to "2022-2025" to reflect the first year when this package and its documentation were published.
Use
%Yplaceholder to specify the year.Note
The package name was
ni-measurement-servicein 2022, then it was renamed toni-measurementlink-servicein 2023, and renamed again toni-measurement-plugin-sdk-servicein 2024.Reformat
pyproject.tomlbecause I have my editor configured to reformat now.Why should this Pull Request be merged?
While setting up Sphinx for another project, I noticed that the Python 3.9 version constraint requires using a Sphinx version from 2023 and the
%Yplaceholder was not supported with that older version.What testing has been done?
Ran
poetry run sphinx-build _docs_source docs -b html -W --keep-goingand inspected the output locally.It printed some warnings about ReadTheDocs's SSL certificates, so I'll check whether the PR build has the same warnings.