-
Notifications
You must be signed in to change notification settings - Fork 41
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
Decide on use of comma after "e.g." and "i.e." #3235
Comments
I'm also in favour of always using the comma. |
I have consulted with our documentation team. Their recommendation (based on Chicago Manual of Style) is that comma should be used after. Before there should also be some punctuation mark. Examples of a punctuation mark before (from the specification):
I haven't looked through all the cases of "i.e." and "e.g". There was one case where there was no punctuation mark before. |
It seems we have consensus, and will try to do it when we have few open PRs. |
As I understand, "i.e." is short for "id est", Latin for "that is", and "e.g." is short for "exempli gratia", Latin for "for the sake of the example", which in English (and I guess also in medieval Latin) are always preceded and followed by a comma. That's why we should always write them ", e.g.," and ", i.e.,". |
* Search and replace fixes. Closes #3235 * Additional ones. Note that I replaced the use of colon before an example with ",". Clearly "e.g.,:" would seem excessive, and it wasn't clear that "e.g.:" is really correct (and it is at least rare). https://en.wikipedia.org/wiki/Colon_(punctuation) indicates that the part before colon should be a complete sentence and these abbrevs. aren't. * Update chapters/classes.tex * Apply suggestions from code review Restore case * Add it to the style guide as well. * Comma Before according to review * One more missing comma before * Better explanation of when to use comma * Apply suggestions from code review * Additional missing comma before. Note that one sentence was rewritten to add a parenthesis around the example-text. Co-authored-by: Elena Shmoylova <eshmoylova@users.noreply.github.com>
Our style guide should give rules for when to use a comma after "e.g." and "i.e.", and the text should be updated to follow whatever is decided. Currently we have a mix of both:
Based on what I find online, including discussions like this,
https://english.stackexchange.com/questions/16172/should-i-always-use-a-comma-after-e-g-or-i-e
I lean towards always requiring the comma for both abbreviations in our document. This would also have the advantage that people editing the sources don't need to remember the special LaTeX behavior that requires the following space to be protected when it appears directly after the period.
The text was updated successfully, but these errors were encountered: