Improve documentation

Author: spier

docs/spell-and-style-checking.md

@@ -8,7 +8,7 @@ Note that we have only started using vale recently (May 2023), and have only use
 
 Further note that we are not sure yet which documentation is best to keep here versus keeping it centrally in the [isc-styles][]. So we might consolidate this documentation at a later point.
 
-## How to check **Learning Path** content using vale (locally)
+## Running the checks for the Learning Path content locally
 
 To run the vale checks locally, you need to install:
 
@@ -25,7 +25,7 @@ Then run vale on the files that you want to check, e.g.:
 
 This will run the checks on all markdown and asciidoc files below the `/project-leader` folder.
 
-Any issues found will be shown in the terminal and would look like this:
+Any issues found will be shown in the terminal like this:
 
 ```bash
  project-leader/outline.md
@@ -37,22 +37,24 @@ Any issues found will be shown in the terminal and would look like this:
                'consollidating'?
 ```
 
-## How to check new Learning Path content coming in via Pull Requests
+## Checking new Learning Path content coming in via Pull Requests
 
 This happens automatically, using GitHub Actions and this workflow [vale.yml](.github/workflows/vale.yml).
 
 Output looks like this:
 
 ![Screenshot 2023-08-02 at 22 41 08](https://github.com/InnerSourceCommons/InnerSourceLearningPath/assets/163029/8dda3c81-634c-48db-9a2f-3f216b717e97)
 
-You should only have to adapt that workflow when adding entirely new sections to the Learning Path.
+Note that this highlighting will only be done for any issues found in lines that were changed in the given Pull Request. The idea here is that a contributor should only have to review style issues in the content that they have added themselves.
+
+You should only have to adapt the GitHub Actions workflow in [vale.yml](.github/workflows/vale.yml) when adding entirely new sections to the Learning Path.
 
 ## How to add exceptions to the spell checker?
 
 There may be times where the Learning Path wants to use spelling differently from what is defined in [isc-styles][]. (Note that we hope that this will be the exception, as otherwise it won't make sense to maintain the styles centrally).
 
 To do so, add the exceptions that you want to make to [accept.txt](.github/vale/Vocab/Base/accept.txt) or [reject.txt](.github/vale/Vocab/Base/reject.txt)
 
-TBD - I think this needs to be described in more detail
+TBD - I think this needs to be described in more detail. Especially when to add exceptions locally, and when to add them to the isc-styles repo.
 
 [isc-styles]: https://github.com/InnerSourceCommons/isc-styles