Repository: streetsidesoftware/cspell-dicts
Pull request #4356: fix: english acronyms
Author: login: ccoVeille
Created: 2025-05-03T17:04:45Z | Merged: 2025-05-03T20:38:31Z

<!---
name: Add to Dictionary
about: PR for adding (to) a dictionary
title: 'fix: '
labels: dictionary
--->

# Add/Fix Dictionary

Dictionary: 

en_AU: add POTUS and BDSM acronym (via en_shared)
en_GB: add POTUS and BDSM acronym (via en_shared)
en_CA: add POTUS and BDSM acronym (via en_shared)
en_US: no changes
software-terms: add DRM

## Description

- **chore: cleanup en_US/src/acronyms.txt from duplicates**
- **feat: move BDSM acronym to en_shared**
- **feat: add POTUS acronym to en_shared**
- **feat: add DRM to software-terms dictionary**
- **chore: move IFTTT to en_US/src/legacy/en_US.txt**
- **chore: add definitions for acronyms**
- **chore: add directive to en_US/src/acronyms.txt**

## References

NA

## Checklist

- [X] By submitting this pull-request, you agree to follow our [Code of Conduct](https://github.com/streetsidesoftware/cspell-dicts/blob/main/CODE_OF_CONDUCT.md)
- [X] Verify that the title starts with the correct prefix:
  - `fix:` - for minor changes like adding words or fixing spelling issues.
  - `feat:` - for a significant change like adding a whole new set of words to a dictionary.
  - `feat!:` - for breaking changes, like file format or licensing changes.
  - `chore:` - for changes that do not impact the content of dictionaries.



Diff:
diff --git a/dictionaries/en_AU/cspell-tools.config.yaml b/dictionaries/en_AU/cspell-tools.config.yaml
index 715e7a364d2..772fe8ebd1e 100644
--- a/dictionaries/en_AU/cspell-tools.config.yaml
+++ b/dictionaries/en_AU/cspell-tools.config.yaml
@@ -6,6 +6,7 @@ targets:
       - ./src/additional_words.txt
       - ./src/hunspell-en_AU-large/en_AU-large.dic
       - ./node_modules/@cspell/aoo-mozilla-en-dict/dicts/en_AU (Kevin Atkinson)/en_AU.dic
+      - ./node_modules/@cspell/dict-en-shared/dict/acronyms.txt
       - ./node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt
     format: trie3
     targetDirectory: '.'
diff --git a/dictionaries/en_CA/cspell-tools.config.yaml b/dictionaries/en_CA/cspell-tools.config.yaml
index 32c8c2f54b8..011b74b457c 100644
--- a/dictionaries/en_CA/cspell-tools.config.yaml
+++ b/dictionaries/en_CA/cspell-tools.config.yaml
@@ -6,6 +6,7 @@ targets:
       - src/additional_words.txt
       - src/hunspell-en_CA-large/en_CA-large.dic
       - node_modules/@cspell/aoo-mozilla-en-dict/dicts/en_CA (Kevin Atkinson)/en_CA.dic
+      - node_modules/@cspell/dict-en-shared/dict/acronyms.txt
       - node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt
     format: trie3
     targetDirectory: '.'
diff --git a/dictionaries/en_GB-ise/cspell-tools.config.yaml b/dictionaries/en_GB-ise/cspell-tools.config.yaml
index f92d9d01a6a..fe830a9f2d5 100644
--- a/dictionaries/en_GB-ise/cspell-tools.config.yaml
+++ b/dictionaries/en_GB-ise/cspell-tools.config.yaml
@@ -8,6 +8,7 @@ targets:
     sources:
       - src/additional_words.txt
       - node_modules/@cspell/aoo-mozilla-en-dict/dicts/en_GB (Marco Pinto) (-ise) (2025+)/en_GB.dic
+      - node_modules/@cspell/dict-en-shared/dict/acronyms.txt
       - node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt
     sort: true
     generateNonStrict: true
diff --git a/dictionaries/en_GB-legacy/cspell-tools.config.yaml b/dictionaries/en_GB-legacy/cspell-tools.config.yaml
index 3e6007f996d..75bcebddece 100644
--- a/dictionaries/en_GB-legacy/cspell-tools.config.yaml
+++ b/dictionaries/en_GB-legacy/cspell-tools.config.yaml
@@ -12,6 +12,7 @@ targets:
     excludeWordsFrom:
       - node_modules/@cspell/aoo-mozilla-en-dict/dicts/en_GB (Marco Pinto) (-ise -ize) (2025+)/en_GB.dic
       - node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt
+      - node_modules/@cspell/dict-en-shared/dict/acronyms.txt
       - node_modules/@cspell/dict-en-shared/dict/exclude-words.txt
       - ../en_GB/src/additional_words.txt
 checksumFile: true
diff --git a/dictionaries/en_GB/cspell-tools.config.yaml b/dictionaries/en_GB/cspell-tools.config.yaml
index b11f54777e6..c8820cb37d1 100644
--- a/dictionaries/en_GB/cspell-tools.config.yaml
+++ b/dictionaries/en_GB/cspell-tools.config.yaml
@@ -8,6 +8,7 @@ targets:
     sources:
       - src/additional_words.txt
       - node_modules/@cspell/aoo-mozilla-en-dict/dicts/en_GB (Marco Pinto) (-ise -ize) (2025+)/en_GB.dic
+      - node_modules/@cspell/dict-en-shared/dict/acronyms.txt
       - node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt
     sort: true
     generateNonStrict: true
diff --git a/dictionaries/en_US/src/acronyms.txt b/dictionaries/en_US/src/acronyms.txt
index 27ff39f2389..5761cf810ad 100644
--- a/dictionaries/en_US/src/acronyms.txt
+++ b/dictionaries/en_US/src/acronyms.txt
@@ -1,20 +1,13 @@
-# Acronyms, and Initialisms
-AITA
-ASAP
-BDSM
-CTA
-DRM
-EEA
-FLOTUS
-FOMO
-IFTTT
-IMAX
-lidar
-lidars
-POTUS
-SCOTUS
-TLDR
-usd
-USD
-VPPA
-YOLO
+# Acronyms, and Initialisms specific to American English only
+#
+# For acronyms that are valid for all English variants,
+# add them to en_shared/src/acronyms.txt
+AITA # Am I the Asshole ?
+CTA # Counter-Terrorism Act (and other acronyms)
+DRM # Digital Rights Management
+EEA # European Economic Area
+FLOTUS # First Lady of the United States
+IFTTT # If This Then That (used in computing)
+POTUS # President of the United States
+SCOTUS # Supreme Court of the United States
+VPPA # Video Privacy Protection Act
diff --git a/dictionaries/en_shared/src/acronyms.txt b/dictionaries/en_shared/src/acronyms.txt
index 7df0c5924f3..07f4f2967b6 100644
--- a/dictionaries/en_shared/src/acronyms.txt
+++ b/dictionaries/en_shared/src/acronyms.txt
@@ -1,10 +1,12 @@
 # Acronyms, and Initialisms
-ASAP
-FOMO
-IMAX
-lidar
-lidars
-TLDR
-usd
-USD
-YOLO
+ASAP # as soon as possible
+BDSM # Sexual practice
+FOMO # fear of missing Out
+IMAX #  Image MAXimum
+lidar # Light Detection And Ranging
+lidars # Light Detection And Ranging (when used as a pluralnoun)
+POTUS # President of the United States
+TLDR # Too Long Don't Read
+usd # US Dollar
+USD # US Dollar
+YOLO # you only live once
diff --git a/dictionaries/software-terms/src/computing-acronyms.txt b/dictionaries/software-terms/src/computing-acronyms.txt
index d1eb7706792..5e0da1c9a05 100644
--- a/dictionaries/software-terms/src/computing-acronyms.txt
+++ b/dictionaries/software-terms/src/computing-acronyms.txt
@@ -104,3 +104,4 @@ xodr
 xosc
 XSD
 ZIP
+DRM # Digital rights management


Reviews:
user: login: Jason3S
body: Thank you.
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T17:18:28Z
user: login: ccoVeille
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T18:04:26Z
user: login: ccoVeille
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T18:05:28Z
user: login: ccoVeille
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T18:08:52Z
user: login: ccoVeille
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T19:43:01Z
user: login: Jason3S
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T19:54:04Z
user: login: Jason3S
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T19:54:36Z
user: login: ccoVeille
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T19:55:59Z
user: login: Jason3S
state: COMMENTED
author_association: COLLABORATOR
submitted_at: 2025-05-03T20:52:34Z

Review comments:
diff_hunk: @@ -23247,3 +23247,5 @@ zymoplastic
 zymoscope
 zyzzyva
 zyzzyvas
+DRM # Digital rights management
path: dictionaries/en_US/src/legacy/en_US.txt
user: login: Jason3S
body: Why add these here? I prefer no new additions to legacy. The meaning of legacy is that it is a legacy list, not a list of legacy terms.
created_at: 2025-05-03T17:13:31Z
author_association: COLLABORATOR
diff_hunk: @@ -1,10 +1,12 @@
 # Acronyms, and Initialisms
-ASAP
-FOMO
-IMAX
-lidar
-lidars
-TLDR
-usd
-USD
-YOLO
+ASAP # as soon as possible
+BDSM # Sexual practice
+FOMO # fear of missing Out
+IMAX #  Image MAXimum
+LIDAR # Light Detection And Ranging
path: dictionaries/en_shared/src/acronyms.txt
user: login: Jason3S
body: `lidar` is allowed in many spelling contexts. So, it is better to keep it lowercase. See: https://en.wikipedia.org/wiki/Lidar
created_at: 2025-05-03T17:14:31Z
author_association: COLLABORATOR
diff_hunk: @@ -3106,3 +3106,4 @@ zipFile
 zlib
 zone
 zones
+DRM   # Digital rights management
path: dictionaries/software-terms/dict/softwareTerms.txt
user: login: Jason3S
body: Why add this here?

Did you intend: `dictionaries/software-terms/src/computing-acronyms.txt`?
created_at: 2025-05-03T17:15:22Z
author_association: COLLABORATOR
diff_hunk: @@ -3106,3 +3106,4 @@ zipFile
 zlib
 zone
 zones
+DRM   # Digital rights management
path: dictionaries/software-terms/dict/softwareTerms.txt
user: login: ccoVeille
body: I missed this source, thanks
created_at: 2025-05-03T18:04:26Z
author_association: COLLABORATOR
diff_hunk: @@ -1,10 +1,12 @@
 # Acronyms, and Initialisms
-ASAP
-FOMO
-IMAX
-lidar
-lidars
-TLDR
-usd
-USD
-YOLO
+ASAP # as soon as possible
+BDSM # Sexual practice
+FOMO # fear of missing Out
+IMAX #  Image MAXimum
+LIDAR # Light Detection And Ranging
path: dictionaries/en_shared/src/acronyms.txt
user: login: ccoVeille
body: I hesitated here, I made back and forth. I shouldn't have committed it
created_at: 2025-05-03T18:05:28Z
author_association: COLLABORATOR
diff_hunk: @@ -23247,3 +23247,5 @@ zymoplastic
 zymoscope
 zyzzyva
 zyzzyvas
+DRM # Digital rights management
path: dictionaries/en_US/src/legacy/en_US.txt
user: login: ccoVeille
body: OK, noted.

I gave the reason in the commit.
I thought I could do it,so I did 😅

Maybe you will be OK if I remove DRM and IFTTT from en_US as they are available in software-terms dictionary.

Otherwise I can either add move them in another file in en_US, or add a comment about them in en_US/src/acronyms.txt
created_at: 2025-05-03T18:08:52Z
author_association: COLLABORATOR
diff_hunk: @@ -23247,3 +23247,5 @@ zymoplastic
 zymoscope
 zyzzyva
 zyzzyvas
+DRM # Digital rights management
path: dictionaries/en_US/src/legacy/en_US.txt
user: login: ccoVeille
body: I chose to let them here for now
created_at: 2025-05-03T19:43:01Z
author_association: COLLABORATOR
diff_hunk: @@ -1,10 +1,12 @@
 # Acronyms, and Initialisms
-ASAP
-FOMO
-IMAX
-lidar
-lidars
-TLDR
-usd
-USD
-YOLO
+ASAP # as soon as possible
+BDSM # Sexual practice
+FOMO # fear of missing Out
+IMAX #  Image MAXimum
+LIDAR # Light Detection And Ranging
path: dictionaries/en_shared/src/acronyms.txt
user: login: Jason3S
body: no worries.
created_at: 2025-05-03T19:54:04Z
author_association: COLLABORATOR
diff_hunk: @@ -1,10 +1,12 @@
 # Acronyms, and Initialisms
-ASAP
-FOMO
-IMAX
-lidar
-lidars
-TLDR
-usd
-USD
-YOLO
+ASAP # as soon as possible
+BDSM # Sexual practice
+FOMO # fear of missing Out
+IMAX #  Image MAXimum
+LIDAR # Light Detection And Ranging
path: dictionaries/en_shared/src/acronyms.txt
user: login: Jason3S
body: ```suggestion
lidar # Light Detection And Ranging
```
created_at: 2025-05-03T19:54:36Z
author_association: COLLABORATOR
diff_hunk: @@ -1,10 +1,12 @@
 # Acronyms, and Initialisms
-ASAP
-FOMO
-IMAX
-lidar
-lidars
-TLDR
-usd
-USD
-YOLO
+ASAP # as soon as possible
+BDSM # Sexual practice
+FOMO # fear of missing Out
+IMAX #  Image MAXimum
+LIDAR # Light Detection And Ranging
path: dictionaries/en_shared/src/acronyms.txt
user: login: ccoVeille
body: I forgot it 🤦‍♂️
created_at: 2025-05-03T19:55:59Z
author_association: COLLABORATOR
diff_hunk: @@ -23247,3 +23247,5 @@ zymoplastic
 zymoscope
 zyzzyva
 zyzzyvas
+DRM # Digital rights management
path: dictionaries/en_US/src/legacy/en_US.txt
user: login: Jason3S
body: There is not need to normalize the dictionaries. Having the same word in multiple places is ok.

Please note: Not everyone is using the software-terms dictionary. It is currently enabled by default, but I hope to turn that off and make it dependent upon the environment.
created_at: 2025-05-03T20:52:34Z
author_association: COLLABORATOR

PR comments:
user: login: Jason3S
created_at: 2025-05-03T17:23:20Z
body: > en_AU: add POTUS and BDSM acronym (via en_shared)
> en_GB: add POTUS and BDSM acronym (via en_shared)
> en_CA: add POTUS and BDSM acronym (via en_shared)

I don't believe this is true. It is necessary to specify the file as a source:


Dictionary Build configuration `en_AU`:
```yaml
targets:
  - name: en_AU
    sources:
      - ./src/additional_words.txt
      - ./src/hunspell-en_AU-large/en_AU-large.dic
      - ./node_modules/@cspell/aoo-mozilla-en-dict/dicts/en_AU (Kevin Atkinson)/en_AU.dic
      - ./node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt
    format: trie3
    targetDirectory: '.'
    generateNonStrict: true
    excludeWordsFrom:
      - node_modules/@cspell/dict-en-shared/dict/exclude-words.txt
checksumFile: true
```

Note that only `./node_modules/@cspell/dict-en-shared/dict/shared-additional-words.txt` is reference.

Need to add: 

```yaml
- node_modules/@cspell/dict-en-shared/dict/acronyms.txt
```

author_association: COLLABORATOR
user: login: ccoVeille
created_at: 2025-05-03T19:57:14Z
body: > > en_AU: add POTUS and BDSM acronym (via en_shared)
> > en_GB: add POTUS and BDSM acronym (via en_shared)
> > en_CA: add POTUS and BDSM acronym (via en_shared)
> 
> I don't believe this is true. It is necessary to specify the file as a source:
> 
> Need to add: 
> 
> ```yaml
> - node_modules/@cspell/dict-en-shared/dict/acronyms.txt
> ```

I only see that now, I'll fix it too

author_association: COLLABORATOR
user: login: ccoVeille
created_at: 2025-05-03T20:13:13Z
body: I fixed the conflicts
author_association: COLLABORATOR