Add basic Vale instructions and terms (#2)

* Add Vale external styles to gitignore

* Add Vale instructions

* Add entries to vocabulary and test file

.gitignore

@@ -105,3 +105,9 @@ dist
 
 # Antora
 build/
+
+# Exclude external styles
+vale/styles
+!vale/styles/Neo4j
+!vale/styles/Vocab
+!vale/styles/Experimental

vale/README.adoc

@@ -1,2 +1,39 @@
 # Vale
 
+## Prerequisites
+
+1. Install Vale according to the instructions on the link:https://vale.sh/docs/vale-cli/installation/[website].
+2. Make sure Vale is installed correctly by running `vale` in the command line.
+3. (Optional) Install the Vale plugin in VSCode.
+
+## Run Vale
+
+The basic way to run Vale is the following:
+
+```
+vale --config /path/to/vale/.vale.ini /path/to/doc/repo/modules/ROOT/pages/index.adoc
+```
+
+Here `/path/to/vale/` is the path to this repository, where the `.vale.ini` file can be found.
+The `/path/to/doc/repo/` instead is the path to the repository containing the docs you want to run Vale on.
+
+For example, run Vale with the included `.ini` file and the test Asciidoc file:
+
+```
+vale --config vale/.vale.ini vale/test.adoc
+```
+
+## Add a style
+
+To add a new style (for example the Google style guide) in the Vale configuration, do the following:
+
+1. Edit the `vale.ini` file to either add `Google` to the `BasedOnStyles` (to add all the style rules by default, and optionally disable some), or add single rules such as `Google.DateFormat = YES`.
+2. Run `vale --config vale/.vale.ini sync` to download the new style (if it has not been downloaded before).
+
+NOTE: Any styles added to the `vale/styles` directory except our custom ones are ignored by `git`.
+
+## Add terms to the vocabulary
+
+You can add terms with their accepted spelling in the `accept.txt` file(s) within the `vale/Vocab` subdirectories.
+
+NOTE: Do not add entries where an entry fully contains another one, such as `Neo4j` and `Neo4j Aura`. Use the `Neo4j/Names.yml` rule for single words instead.

vale/styles/Neo4j/Names.yml

@@ -3,3 +3,4 @@ message: Use '%s' instead of '%s'.
 level: error
 swap:
   - neo4j: Neo4j
+  - cypher: Cypher

vale/styles/Vocab/Neo4j/accept.txt

@@ -1,6 +1,15 @@
-Cypher
+Apache Arrow
+AuraDB Enterprise
+AuraDB Free
+AuraDB Professional
+AuraDS Enterprise
+AuraDS Professional
 Neo4j Aura
 Neo4j AuraDB
 Neo4j AuraDS
 Neo4j Bloom
 Neo4j Browser
+Neo4j Cypher Shell
+Neo4j Desktop
+Neo4j Server
+Spring Boot

vale/test.adoc

@@ -0,0 +1,7 @@
+Use the Neo4j browser.
+Use the browser.
+Use neo4j.
+Open Neo4j AuraDb.
+Use AuraDB enterprise.
+Use Neo4j AuraDb enterprise.
+Read the cypher cheatsheet.