diff --git a/docs/_sidebar.md b/docs/_sidebar.md
index c3dda27e5..63b2fafa8 100644
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@@ -22,7 +22,7 @@
   - [Tutorials](Tutorials.md)
   - [API-Usage](usage.md)
   - [Configurations](Setup.md)
-  - [Directives](8.6.0_docs.md)
+  - [Directives](directives.md)
   - [Theming](theming.md)
   - [mermaid CLI](mermaidCLI.md)
   - [Advanced usage](n00b-advanced.md)
@@ -34,6 +34,5 @@
 - Contributions and Community 🙌
 
   - [Development and Contribution ](development.md)
-  - [Mermaid Versions](versionUpdates.md)
   - [Changelog](CHANGELOG.md)
   - [Adding Diagrams ](newDiagram.md)
diff --git a/docs/directives.md b/docs/directives.md
index 8d4b3f4aa..9e33f5b45 100644
--- a/docs/directives.md
+++ b/docs/directives.md
@@ -2,10 +2,8 @@
 
 **Edit this Page** [![N|Solid](img/GitHub-Mark-32px.png)](https://github.com/mermaid-js/mermaid/blob/develop/docs/directives.md)
 
-## Directives were added in [Version 8.6.0](../getting-started/8.6.0_docs.md). Please Read it for more information.
-
 ## Directives
-With this version, directives are supported. Directives are divided in two sets, by priority. the first set, containing 'init' or 'initialize' directives take priority. While the other set, containing all other kinds of directives are considered only after 'init' and the graph-type declared.
+Directives gives a diagram author the possibility to update the diagram configuration from the diagram text. Directives are divided in two sets by priority. The first set, containing 'init' or 'initialize' directives take priority. While the other set, containing all other kinds of directives are considered only after 'init' and the graph-type declared.
 
 #### Init
 
diff --git a/docs/theming.md b/docs/theming.md
index 68343fb8c..f0dbf13c2 100644
--- a/docs/theming.md
+++ b/docs/theming.md
@@ -1,4 +1,6 @@
-# Version 8.7.0: Theme Configuration
+# Theme Configuration
+
+**Edit this Page** [![N|Solid](img/GitHub-Mark-32px.png)](https://github.com/mermaid-js/mermaid/blob/develop/docs/theming.md)
 
 With Version 8.7.0 Mermaid comes out with a system for dynamic and integrated configuration of the diagram themes. The objective of this is to increase the customizability of mermaid and the ease of Styling, with the customization of themes through the `%%init%%` directive and `initialize` calls.