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
Docstring clarifications #9877
Docstring clarifications #9877
Conversation
While trying to understand Sphinx, I had a few troubles and tried to improve what I found difficult. In particular: * Why "addnodes" where described as docutil nodes * whether "centered" is for deprecated text or whether it is deprecated * what is pending_xref_condition * what means "forcedly" * Why some script can take no filename while it is marked as a str argument (by consistency, I changed similarly css) * why ProductionList counted the number of rules * how come verify_needs_extensions actually verifies
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.
Thanks a lot for all these updates!
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 with nits.
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
Thanks a lot for those reviews. Sorry for not paying as much attention as I should have to the difference between directive and roles. I'll try to do better if I submit again (which will probably be the case, given that I've still not been able to do understand how to do what I was trying to do in the first place) |
Co-authored-by: Takeshi KOMIYA <i.tkomiya@gmail.com> Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
# Conflicts: # sphinx/addnodes.py # sphinx/application.py
Thanks Arthur! A |
Subject: Clarifying some documentation sentences that I found confusing
Feature or Bugfix
### Branch
Before posting a pull request, please choose a appropriate branch:
While trying to understand Sphinx, I had a few troubles and tried to improve
what I found difficult.
In particular:
(by consistency, I changed similarly css)