diff --git a/README.md b/README.md
index 6f0ac59..3668566 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ The validator enforces semantic restrictions which cannot be expressed by the JS
 
 The linter applies a lightly opinionated set of 'best practices' to your API document, making it complete and comprehensive, as opposed to merely minimally valid.
 
-The best documentation currently for the linter rules is that of [Speccy](http://speccy.io/rules/1-rulesets), which shares code with this project. The linter [rules format](https://mermade.github.io/oas-kit/linter-rules.html) is also documented.
+The default linter rules are documented [here](https://mermade.github.io/oas-kit/default-rules.html). The linter [DSL rules format](https://mermade.github.io/oas-kit/linter-rules.html) is also documented.
 
 ## Features
 
diff --git a/extension.js b/extension.js
index bdf6c1c..ff78ea5 100644
--- a/extension.js
+++ b/extension.js
@@ -268,6 +268,8 @@ function activate(context) {
         return optionallyValidateOnSave(document);
     }));
     console.log('openapi-lint: Installed save handler');
+    // you can return an API from your extension for use by other extensions
+    // or tests etc
 }
 exports.activate = activate;