diff --git a/docs/8.6.0_docs.md b/docs/8.6.0_docs.md
index 850a93bd6..a66d8a83f 100644
--- a/docs/8.6.0_docs.md
+++ b/docs/8.6.0_docs.md
@@ -6,8 +6,8 @@
 
 With version 8.6.0 comes the release of directives for mermaid, a new system for modifying configurations, with the aim of establishing centralized, sane defaults and simple implementation.
 
-`directives` allow for a diagram specific overriding of `config`, as it has been discussed in [Configurations](./Setup.md).
-This allows site users to input modifications to `config` alongside diagram definitions, when creating diagrams on a private webpage that supports mermaid.
+`directives` allow for a single-use overwriting of `config`, as it has been discussed in [Configurations](./Setup.md).
+This allows site Diagram Authors to instantiate temporary modifications to `config` through the use of [Directives](), which are parsed before rendering diagram definitions. This allows the Diagram Authors to alter the appearance of the diagrams. 
 
 **A likely application for this is in the creation of diagrams/charts inside company/organizational webpages, that rely on mermaid for diagram and chart rendering.**