Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Short description
This PR resolves the build warnings when building the docs with the latest Sphinx versions. Additionally, some missing issue/PR links have been added.
Proposed changes
Set language code to English due to:
Switch to the new
intersphinx_mapping
format due to:Add a newline to resolve
Use the issue/PR number for the issue and PR directive labels to fix
This is documented in the official docs at https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html: The caption (the second tuple element) needs to always be either
None
to use the full URL or a string which contains the placeholder%s
exactly once.Additionally, the directives have been fixed to use the format from the official docs inside the actual RST.
Resolved issues
Fixes: #710