devguide icon indicating copy to clipboard operation
devguide copied to clipboard

Remove e.g. and i.e. throughout

Open nedbat opened this issue 1 year ago • 2 comments

I'm not sure if this is controversial or not. It's ready to merge if people like it.


📚 Documentation preview 📚: https://cpython-devguide--1343.org.readthedocs.build/

nedbat avatar Jul 02 '24 20:07 nedbat

Is there any background for this decision? I did a quick search and there are some article about using e.g. instead of eg or eg., but didn't find style guides that recommend against using them.

ezio-melotti avatar Jul 03 '24 07:07 ezio-melotti

Here's some style guides recommending against Latin abbreviations:

  • Google: https://developers.google.com/style/abbreviations
  • Microsoft: https://learn.microsoft.com/en-us/style-guide/word-choice/use-us-spelling-avoid-non-english-words
  • Red Hat: https://stylepedia.net/style/6.2/#contractions-and-abbreviations
  • Apple: https://support.apple.com/en-gb/guide/applestyleguide/apsg3acde405/1.0/web/1.0#apde9a26a57d4df4
  • Intuit: https://contentdesign.intuit.com/word-list/#i-e
  • Salesforce: https://developer.salesforce.com/docs/atlas.en-us.salesforce_pubs_style_guide.meta/salesforce_pubs_style_guide/style_ie.htm
  • edX: https://draft-edx-style-guide.readthedocs.io/en/latest/global_English.html#abbreviations
  • GOV.UK: https://insidegovuk.blog.gov.uk/2016/07/20/changes-to-the-style-guide-no-more-eg-and-ie-etc/ https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style#eg-etc-and-ie
  • Australian Government Style Manual: https://www.stylemanual.gov.au/grammar-punctuation-and-conventions/shortened-words-and-phrases/latin-shortened-forms
  • "Most style manuals (APA, MLA, and Chicago) suggest limiting the use of Latin abbreviations in the main text": https://paperpal.com/blog/academic-writing-guides/language-grammar/abbreviations-in-research

hugovk avatar Jul 03 '24 09:07 hugovk