Skip to content

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

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.

Sign up for GitHub

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

Jump to bottom
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
Labels
Documentation

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
@cimarronm
Normalize all 'e.g.' instances. Addresses issue matplotlib#1423.
3a8d7f0
pelson added a commit that referenced this issue Apr 18, 2013
@pelson
Merge pull request #1916 from cimarronm/normalize_eg
3c5bd38 
Normalize all 'e.g.' instances. Addresses issue #1423.
@pelson pelson mentioned this issue Apr 18, 2013
Merged
@pelson pelson closed this as completed Apr 18, 2013
@tacaswell tacaswell mentioned this issue Nov 1, 2014
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
Documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
4 participants
@mdboom @ivanov @dmcdougall @pelson