From d5b90bcdecdbcf62a2d6135e97beb8eca8e97214 Mon Sep 17 00:00:00 2001 From: Ross Patterson Date: Mon, 15 May 2023 17:34:35 -0700 Subject: [PATCH] docs(vocab): Clarify multiple vocabulary usage This was a big point of confusion for me getting started with Vale. I ended up doing some trial and error to figure out the behavior of the `Vocab` setting. Hopefully this, or some other clarifying language might save others the same confusion. --- content/en/docs/topics/vocab/index.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/content/en/docs/topics/vocab/index.md b/content/en/docs/topics/vocab/index.md index 8afb0760..008ace32 100644 --- a/content/en/docs/topics/vocab/index.md +++ b/content/en/docs/topics/vocab/index.md @@ -32,10 +32,11 @@ Vocab = Some-Name BasedOnStyles = Vale, MyStyle ``` -Each `Vocab` is a single folder (stored at `/Vocab//`) -consisting of two plain-text files—`accept.txt` and -`reject.txt`—that contain one word, phrase, or regular expression per -line. +Each `Vocab` is a single folder (stored at `/Vocab//`) consisting of +two plain-text files—`accept.txt` and `reject.txt`—that contain one word, +phrase, or regular expression per line. Vocabularies cannot be defined in +format-specific settings. Use multiple config files to use different vocabularies for +different formats. The effects of using a custom `Vocab` are as follows: