diff --git a/docs/configuration/astronvim/index.md b/docs/configuration/astronvim/index.md
deleted file mode 100644
index 685b1d0b..00000000
--- a/docs/configuration/astronvim/index.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# Config Design - AstroNvim
-
-[:globe_with_meridians: AstroNvim](https://astronvim.com/) is a community configuration with an engaging UI, using Lazy for plugin management (Neovim packages) and Mason for package management (LSP, DAP, format and lint tools)
-
-[:fontawesome-brands-github: Practicalli AstroNvim User Config](https://github.com/practicalli/astro) is a user configuration that extends AstroNvim and imports packages from the [:fontawesome-brands-github: AstroNvim Community](https://github.com/AstroNvim/user_example).
-
-
-## Neovim Configuration
-
-Practicalli Neovim is based on [AstroNvim](astronvim/), a thoughtful configuration that supports the latest Neovim stable releases, provides a polished UI and many community extensions.
-
-Practicalli AstroNvim User Config provides a complete Clojure config on top of AstroNvim.
-
-[Install Practicalli AstroNvim Config](astronvim/index.md){.md-button} 
-
-
-> NOTE: [Practicalli Neovim Config Redux](practicalli/) was a learning experiment that provided mnemonic key bindings, packer, telescope selector, written in Fennel.  This project has now been archived in favour of AstroNvim
-
-
-
-
-
-
-### Configure format rules
-
-The configuration files for each lint and format tool should be used by Neovim.
-
-> Setting a different location for these files has proved challenging.  `plugin/null-ls.lua` has a section to override its builtin configuration for each lint and format tool, however, in tests Practicalli was unable to succeffuly set a different location.
diff --git a/docs/configuration/astronvim/astrocommunity.md b/docs/reference/configuration/astrocommunity.md
similarity index 100%
rename from docs/configuration/astronvim/astrocommunity.md
rename to docs/reference/configuration/astrocommunity.md
diff --git a/docs/configuration/astronvim/config-design.md b/docs/reference/configuration/index.md
similarity index 90%
rename from docs/configuration/astronvim/config-design.md
rename to docs/reference/configuration/index.md
index 5d4f3629..3a30e9cf 100644
--- a/docs/configuration/astronvim/config-design.md
+++ b/docs/reference/configuration/index.md
@@ -1,10 +1,12 @@
-# 📦 Practicalli AstroNvim Config Design
+# 📦 Practicalli Astro Config Design
 
 A guide to the design of AstroNvim Config created by Practicalli to support a comprehensive development workflow.
 
 ??? INFO "AstroCommunity Plugin Configurations used where available"
     Plugin configurations from AstroCommunity are used to minimise the code size and maintenance of the Practicalli configuration
 
+!!! WARNING "Under review after migration to AstroNvim 4"
+
  
 ## Files overview
 
@@ -34,11 +36,12 @@ The file structure as taken from the AstroNvim template and new files were creat
 - :octicons-file-16: :material-close-circle-outline: `neo-tree.lua` visual file navigator - example config
 - :octicons-file-16: :material-close-circle-outline: `none-ls.lua` example config for format & lint tools
 - :octicons-file-added-16: :material-close-circle-outline: `platuml.lua` UML diagrams defined with code - requires plantuml.com install
-- :octicons-file-added-16: `practicalli.lua` theme, dashboard & key binding preferences enjoyed by Practicalli
 - :octicons-file-added-16: `snippets.lua` load JSON style snippet definitions
 - :octicons-file-added-16:`telescope.lua` ensure Treesitter languages are installed (AstroCommunity language packs also ensure parsers installed)
 - :octicons-file-16: :material-close-circle-outline: `treesittter.lua` ensure Treesitter languages are installed (AstroCommunity language packs also ensure parsers installed)
-- :octicons-file-16: :material-close-circle-outline: `user.lua` example user configuration, added via `lua/plugins/practicalli.lua`
+- :octicons-file-16: :material-close-circle-outline: `user.lua` example user configuration, added via `lua/plugins/user-practicalli.lua`
+- :octicons-file-added-16: `user-practicalli.lua` theme, dashboard & key binding preferences enjoyed by Practicalli
+- :octicons-file-added-16: `user-termux.lua` mason lsp server overrides, pinned plugin versions for neovim 0.9.x 
 
 
 ## Clojure support
@@ -446,6 +449,64 @@ else
 ```
 
 
+<!--
+
+
+# Config Design - AstroNvim
+
+[:globe_with_meridians: AstroNvim](https://astronvim.com/) is a community configuration with an engaging UI, using Lazy for plugin management (Neovim packages) and Mason for package management (LSP, DAP, format and lint tools)
+
+[:fontawesome-brands-github: Practicalli AstroNvim User Config](https://github.com/practicalli/astro) is a user configuration that extends AstroNvim and imports packages from the [:fontawesome-brands-github: AstroNvim Community](https://github.com/AstroNvim/user_example).
+
+Practicalli AstroNvim User Config provides a complete Clojure config on top of AstroNvim.
+
+
+!!! WARNING "Page being rewritten"
+
+## Template desing
+
+
+## Practicalli Changes
+
+
+## Practicalli Additions
+
+
+### User file
+
+Lua files under `lua/plugins/` load in alphabetical order.  Each configuration file should be independent from each other.
+
+A `lua/plugins/user-name.lua` file is an approprate place to override plugin defaults, as it will be the last configuration file to load.
+
+
+## Adding Your own Plugins
+
+- create a `lua/plugins/plugin-name.lua` with all the configuration and key mappings
+- add to a `lua/plugins/user-name.lua` 
+
+- community.lua when using a Plugin Config from Astro Community
+
+Review the `lua/plugins/example-config.lua` file for examples of adding and configuring plugins
+
+
+### Add LSP DAP Lint and Format tools
+
+`SPC p m` to launch Mason which manages LSP servers, linters, filters ...
+
+![AstroNvim packages - mason all installed](https://github.com/practicalli/graphic-design/blob/live/editors/neovim/astronvim/astronvim-packages-mason-installed-all.png?raw=true){loading=lazy}
+
+
+### Configure format rules
+
+The configuration files for each lint and format tool should be used by Neovim.
+
+> Setting a different location for these files has proved challenging.  `plugin/null-ls.lua` has a section to override its builtin configuration for each lint and format tool, however, in tests Practicalli was unable to succeffuly set a different location.
+
+
+-->
+
+
+
 <!--
 
 ## Telescope Extensions
diff --git a/mkdocs.yml b/mkdocs.yml
index 335ffe8b..fd384fa0 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -139,12 +139,6 @@ nav:
       - Neovim: install/neovim.md
       - Multiple Configs: install/multiple-configurations.md
       - Neovide: install/neovide.md
-  - Neovim configuration:
-      - configuration/index.md
-      - AstroNvim:
-          - configuration/astronvim/index.md
-          - AstroCommunity: configuration/astronvim/astrocommunity.md
-          - Config Design: configuration/astronvim/config-design.md
   - Neovim Basics:
       - neovim-basics/index.md
       - File Buffer Window Tab: neovim-basics/file-buffer-window-tab.md
@@ -189,6 +183,9 @@ nav:
       - Clojure: termux/clojure-development.md
       - Neovim: termux/neovim.md
   - Reference:
+      - Astro config Design:
+          - reference/configuration/index.md
+          - AstroCommunity: reference/configuration/astrocommunity.md
       - Modal Editing:
           - reference/modal-editing/index.md
           - reference/modal-editing/case.md
@@ -213,7 +210,7 @@ nav:
       - Lua Language:
           - reference/lua-language/index.md
       - Fennel: reference/fennel.md
-      - Practicalli:
+      - Practicalli Config Design:
           - reference/configuration/practicalli/index.md
           - Config Design: reference/configuration/practicalli/config-design.md
           - Packer: reference/configuration/practicalli/packer.md