search

errata-ai / Microsoft

A Vale-compatible implementation of the Microsoft Writing Style Guide.
https://github.com/errata-ai/vale
MIT License
84 stars 46 forks source link

False positives for ComplexWords rule #36

Closed koenvervloesem closed 3 years ago

koenvervloesem commented 3 years ago

I have a sentence using "address bar". The ComplexWords rule of the Microsoft style suggests to use 'discuss' instead of 'address'. I tried to add "address bar" to accept.txt in my vocabulary, but the rule still flags it. Am I using this wrong or is this an error in Vale and/or the Microsoft style?

jdkato commented 3 years ago

This isn't an error, really. Many of the suggestion-level alerts only look for the presence of a word/phrase without considering the context.

If you find this more bothersome than helpful, you can either disable a specific rule (in this case, ComplexWords) or raise the MinAlertLevel.

koenvervloesem commented 3 years ago

Right, but my question was more about the correct way to add exceptions to the rule (I should have made this clearer in the title of this issue). After reading https://docs.errata.ai/vale/vocab I thought that by adding "address bar" or "IP address" to the accept.txt file for my Vocab, Vale would ignore these word groups for the ComplexWords rule. Am I reading this wrong?