Spell check only specification/**, match spell checking behavior with SpellCheck - All

[danieljurek]

Current cspell config is generating too many errors in non specification/ folders. Most value is created when cspell scans specification/. This PR scopes cspell to check only files in the specification/ folder.

cspell does not support !specification/** so the exclusions are crude. If a PR is opened which introduces a new file into the root of the repo, spell check will fail on spelling error detections.

Tests

SpellCheck

Errors in both specification/ (included) and documentation/ (excluded) folder (note only errors described are in specification/ and none from documentation/: https://github.com/Azure/azure-rest-api-specs/actions/runs/12822906068/job/35756574727?pr=32195#step:3:41

No errors in PR: https://github.com/Azure/azure-rest-api-specs/actions/runs/12822920970/job/35756614201

SpellCheck - All

Spell Check - All with errors in both specification/ and documentation/ (note only errors described are in specification/ and not documentation/): https://github.com/Azure/azure-rest-api-specs/actions/runs/12822909744/job/35756584823#step:3:34414

Spell Check - All with no errors: https://github.com/Azure/azure-rest-api-specs/actions/runs/12822928529/job/35756633557

Other info

Another perk: because the cspell.yaml and cspell.json files are still in the root of the repo you get spell checking of files outside of the specification/ cone in vscode if you have the spell check extension:

Globbing does not fully support negations because the node-glob library used does not: https://cspell.org/docs/globs/ (search for !)

The ignorePaths in cspell.yaml involving directories are evaluated from the root of the config file... So node_modules/** will not exclude node_modules/** folders found in specification/, it will only exclude them if they're found in the same folder as the declaring cspell.yaml that excludes them. However, filenames like cspell.yaml are ignored wherever they are found.

[openapi-pipeline-app]

Next Steps to Merge

✅ All automated merging requirements have been met! To get your PR merged, see aka.ms/azsdk/specreview/merge.

[openapi-pipeline-app]

PR validation pipeline restarted successfully. If there is ApiView generated, it will be updated in this comment.

[mikeharder]

Can we use glob pattern * to match all files in root without listing them individually? I agree we'll need to list each folder in root using foo/**.