more docs tweaks

Author: chris48s

docs/build-plugin-docs.mjs

@@ -38,6 +38,8 @@ custom_edit_url: null
 
 # Plugin API Reference
 
+v8r plugins extend the [BasePlugin](#BasePlugin) class. Validating a document yields a [ValidationResult](#ValidationResult) object.
+
 `;
 tempFiles.forEach((file) => {
   if (fs.existsSync(file.filename)) {

docs/docs/configuration.md

@@ -20,7 +20,7 @@ v8r only searches for a config file in the current working directory.
 
 Example yaml config file:
 
-```yaml
+```yaml title=".v8rrc.yml"
 # - One or more filenames or glob patterns describing local file or files to validate
 # - overridden by passing one or more positional arguments
 patterns: ['*json']

docs/docs/plugins/using-plugins.md

@@ -10,4 +10,12 @@ Plugins can be packages installed from a registry like [npm](https://www.npmjs.c
 
 Plugins must be specified in a [config file](../configuration.md). They can't be loaded using command line arguments.
 
-Plugins are run one at a time in the order they are specified in your config file.
+```yaml title=".v8rrc.yml"
+plugins:
+    # Plugins installed from NPM (or JSR) must be prefixed by "package:"
+    - "package:v8r-plugin-emoji-output"
+    # Local plugins must be prefixed by "local:"
+    - "local:./subdir/my-local-plugin.mjs"
+```
+
+Plugins are invoked one at a time in the order they are specified in your config file.

docs/docs/plugins/writing-plugins.md

@@ -37,9 +37,9 @@ These hooks may optionally return or not return a value. Each plugin is run in s
 
 ## Worked Example
 
-Lets build a simple example plugin. Our plugin is going to register an output format called "emoji". If the user passes `--format emoji` the plugin will output a 👍 when the file is valid and a 👎 when the file is invalid instead of the default text log message.
+Lets build a simple example plugin. Our plugin is going to register an output format called "emoji". If the user passes `--format emoji` (or sets `format: emoji` in their config file) the plugin will output a 👍 when the file is valid and a 👎 when the file is invalid instead of the default text log message.
 
-```js
+```js title="./plugins/v8r-plugin-emoji-output.js"
 // Our plugin extends the BasePlugin class
 import { BasePlugin } from "v8r";
 
@@ -84,3 +84,10 @@ class EmojiOutput extends BasePlugin {
 // and the plugin class must be the default export
 export default EmojiOutput;
 ```
+
+We can now register the plugin in our config file:
+
+```yaml title=".v8rrc.yml"
+plugins:
+    - "local:./plugins/v8r-plugin-emoji-output.js"
+```