Skip to content

Apply consistent use of 'e.g.' and 'i.e.' #605

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

hsnabszhdn
Copy link

@hsnabszhdn hsnabszhdn commented Jul 4, 2025

eg, e.g, e.g:, eg: are randomly all over the place. This PR is to make their usage consistent following these rules:

  1. Grammatically speaking, it's e.g. and i.e. and all other variant are incorrect. References:
  2. Controversial (up for discussion): There should be a comma after e.g. and i.e., but having 3 punctuation marks in a 2-letter word looks so weird: e.g., or i.e., especially when they come in parentheses which is yet another punctuation: (e.g., SENTENCE) or (i.e., SENTENCE)
    • I went out on a limb here and made everything look like: (e.g. SENTENCE) and (i.e. SENTENCE) (There was already some usage of this pattern in the repo, so it's not just made-up in this PR, and rather making all the same)
  3. Controversial (up for discussion): When outside parentheses and at the start of an actual paragraph/sentence, e.g. and i.e. suggest laziness for typing the actual words For example and That is rather than conciseness.
    • Therefore, you'll see e.g. in this PR getting replaced by For example when coming at the beginning of a paragraph/sentence.

@hsnabszhdn hsnabszhdn requested a review from a team as a code owner July 4, 2025 01:48
@hsnabszhdn
Copy link
Author

@microsoft-github-policy-service agree

Copy link

@Dawnmarie-2578 Dawnmarie-2578 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hsnabszhdn hsnabszhdn force-pushed the apply-consistent-use-of-eg-ie branch from 19a92af to 512ae36 Compare July 4, 2025 01:57
@hsnabszhdn hsnabszhdn force-pushed the apply-consistent-use-of-eg-ie branch from 512ae36 to c600c4f Compare July 4, 2025 02:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants