From 1efcd32cda6450f1db435c33ce73bb28c9dcf2ac Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Sat, 8 Mar 2025 02:41:32 +0100 Subject: [PATCH] Expand word list in admin/notes/jargon * admin/notes/jargon: Add some more acronyms, remove some rare ones, add section headers "Acronyms" and "Glossary", add entries under "Glossary", sort, fix formatting, realign. --- admin/notes/jargon | 101 +++++++++++++++++++++++++++++++-------------- 1 file changed, 69 insertions(+), 32 deletions(-) diff --git a/admin/notes/jargon b/admin/notes/jargon index 93ac3506fc6..aa214b289e0 100644 --- a/admin/notes/jargon +++ b/admin/notes/jargon @@ -1,38 +1,75 @@ Glossary of Abbreviations, Acronyms, and Jargon This document provides a list of common abbreviations, acronyms, and -jargon used in emacs-devel@gnu.org. This is a non-exhaustive list. +jargon used on emacs-devel@gnu.org. This is a non-exhaustive list. Feel free to expand as needed. ---- +See also (info "(emacs) Glossary"). -AKA - Also known as -ASAP - As soon as possible -AFAICT - As far as I can tell -BTW - By the way -DTRT - Do the right thing -FYI - For your information -FWIW - For what it's worth -HTH - Hope this helps -ICYMI - In case you missed it -IIRC - If I recall correctly -IIUC - If I understand correctly -IMO - In my opinion -IMHO - In my humble opinion -IMNSHO - In my not so humble opinion -IOW - In other words -LMK - Let me know -LGTM - Looks good to me -NBD - No big deal -NP - No problem -OTOH - On the other hand -PFA - Please find attached -POV - Point of view -TBH - To be honest -TL;DR - Too long; didn't read -TRT - The right thing -TIA - Thanks in advance -WIP - Work in progress -WFM - Works for me -WRT - With respect to -YMMV - Your mileage may vary + +## Glossary + +bikeshedding – excessive discussion over minor details rather than + focusing on the main issue +bitrot – gradual deterioration of software due to changes in + its environment or dependencies +cockpit error - user error +code smell – an indication that a section of code may have + underlying issues or could be improved +foo, bar, baz – generic placeholder names used in examples and + documentation +gross – an inelegant, messy, or overly complicated solution + that works but is suboptimal; describes necessary + workarounds or code that should ideally be improved +hysterical raisins - historical reasons +install on - push to Git branch in repository +notabug - an issue reported as a bug but deemed to be + expected behavior +paper cut – a minor but annoying issue that should be easy to fix +pilot error - user error +yak shaving – engaging in a series of seemingly unrelated tasks + to accomplish an initial goal +wontfix – an issue reported as a bug but that won't be fixed, + often due to design decisions or low priority + + +## Abbreviations + +AFAICT - as far as I can tell +AFAIK - as far as I know +AFAIR - as far as I remember +AFAIU - as far as I understand +AKA - also known as +ASAP - as soon as possible +BTW - by the way +CL - Common Lisp +DTRT - do the right thing +DWIM - do what I mean +ENOPATCH - no patch is attached +FTR - for the record +FWIW - for what it's worth +FYI - for your information +GNU - GNU is not Unix +HTH - hope this helps +IANAL - I am not a lawyer +ICYMI - in case you missed it +IIRC - if I recall correctly +IIUC - if I understand correctly +IMHO - in my humble opinion +IMNSHO - in my not so humble opinion +IMO - in my opinion +IOW - in other words +LGTM - looks good to me +LMK - let me know +OOTB - out of the box +OTOH - on the other hand +SNAFU - situation normal, all fouled up +TBD - to be determined +TBH - to be honest +TIA - thanks in advance +TL;DR - too long; didn't read +TRT - the right thing +WFM - works for me +WIP - work in progress +WRT - with respect to +YMMV - your mileage may vary