-
Notifications
You must be signed in to change notification settings - Fork 37
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
Minor typo and formatting fixes for symmetries #486
Conversation
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.
I support moving conventions under "Requirements/Conventions". Other changes are small, nevertheless appropriate.
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.
I had an additional look at the rendered version of the file and the indentation of some lists seems a bit off (see marked suggestions).
- Fix bulletpoint formatting
Co-authored-by: Antanas Vaitkus <[email protected]> - Apply suggestions from code review Co-authored-by: Antanas Vaitkus <[email protected]> - Update optimade.rst Co-authored-by: Antanas Vaitkus <[email protected]>
5f38d43
to
77864b9
Compare
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.
Looks good, feel free to ignore the two newly added nitpicky comments.
fb20e6e
to
0892136
Compare
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!
Symmetry operation strings that comprise the :property:`space_group_symmetry_operation_xyz` property MUST conform to the following regular expressions. | ||
Symmetry operation strings that comprise the :property:`space\_group\_symmetry\_operations\_xyz` property MUST conform to the following regular expressions. |
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.
Is quoting underscores inside custom roles in rst necessary? This footnote leads me to think that it is not?: https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#footnote-reference-3
Some testing does seem to suggest it doesn't really harm anything for custom roles, so I guess it is ok to do it. In literal context (double backticks) the backslashes are rendered.
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.
The main fix here was the typo in the field name, perhaps I was over cautious with the \
...
Just a few things that popped up whilst implementing the new symmetry operations.
I think it's better to rearrange the big block descriptions into the "Requirements/conventions" sections to follow how we do it with other fields (see the second commit here) but happy to roll that one back.