Skip to content
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

Normalize e.g. instances, or reduce them? #1423

Closed
ivanov opened this issue Oct 21, 2012 · 3 comments
Closed

Normalize e.g. instances, or reduce them? #1423

ivanov opened this issue Oct 21, 2012 · 3 comments

Comments

@ivanov
Copy link
Member

ivanov commented Oct 21, 2012

We have all possible combinations of EG, Eg, eg, E.G., e.g., Eg., etc sprinkled throughout docstrings.

maybe I'm just being weird, but I think we should normalize them (have all spelled with two periods) and/or reduce their usage where it becomes a visual nuisance.

I can imagine how it might be confusing - even though this is a latin abbreviation - for a non-native english speaker to try to parse out what the word "eg" might mean, and wonder if it's just a typo of 'egg', or something.

@mdboom
Copy link
Member

mdboom commented Oct 22, 2012

+100.

@mdboom
Copy link
Member

mdboom commented Oct 22, 2012

BTW -- My "Chicago Manual of Style" recommends following e.g. with a comma in most cases.

@dmcdougall
Copy link
Member

BTW -- My "Chicago Manual of Style" recommends following e.g. with a comma in most cases.

+1.

I think it is uncouth to start a sentence with E.g,.

cimarronm added a commit to cimarronm/matplotlib that referenced this issue Apr 17, 2013
pelson added a commit that referenced this issue Apr 18, 2013
Normalize all 'e.g.' instances. Addresses issue #1423.
@pelson pelson closed this as completed Apr 18, 2013
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants