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
docs: update of readthedocs config and docs/source/conf.py #2909
Conversation
d030eb1
to
7c24a47
Compare
# ref: https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration | ||
|
||
# Set the default role so we can use `foo` instead of ``foo`` | ||
default_role = "literal" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What's the impact of removing default_role
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Its purpose is for rST docs i think, so none in this project without rST.
Goal: reduced complexity.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Example
With default_role as literal in rST, you can write `test` to have it in code style
Without default_role as literal in rST, you must write ``test`` to have it in code style
Co-authored-by: Simon Li <orpheus+devel@gmail.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
Thanks for review @choldgraf!! ❤️ 🎉 Going for a merge as I think this PR isn't justified taking up further review efforts |
Refactoring and chore updates to docs/conf.py and .readthedocs.yaml
Related