devguide
devguide copied to clipboard
Remove e.g. and i.e. throughout
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/
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.
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