Overview

This is a list of acronyms in VA today.

Among other things, this list powers a DSVA and Lighthouse Slack bot.

Contributing

1. Edit the acronyms.csv file.
   • When adding a definition, please add a concise blurb in the context column about how this term is relevant to our work. You can wrap text in quotes to avoid punctuation breaking the CSV.
2. Commit your changes.
3. Create a pull request; if the CI tests pass you can merge it yourself. The tests may take a a few minutes to complete.

The @all-va github team should have write access.

CI

Any changes to the acronyms file will trigger a CI job that will run lint on the acronyms file to check for errors. Any other changes will trigger a scripts-CI job that will run unit tests on scripts in this repository used to cleanup the acronyms file.

Clean up

The terms can be cleaned up for duplicates and sorted via the cleanup script.

Run it via cd scripts && ./clean.sh. An output.csv file will be generated that you can replace the acronyms.csv file with.

csvlint

You can (optionally) install csvlint to check the format of the acronyms file. You can install it with make csvlint-install and then run it with make csvlint

Other cleanup scripts

• make format-acronyms to fix other issues with the acronyms file, such as moving any all-lower-case or all-upper-case definition strings to title case, and turning smart quotes (e.g. “”‘’) to regular quotes. It will output to stdout.
• make dupe-acronyms will output to stdout acronyms that have multiple definitions. It can be used to check for potential duplicates.
• make dupe-definitions will output to stdout definitions that are the same across different acronyms.
• make spelling-check will check the spelling of all of the words in the acronyms file and print out potential errors. You need to run make spelling-tool-install first.