Optimized the structure.

Author: DariuszDepta

.vitepress/config.mts

@@ -6,57 +6,48 @@ export default withMermaid({
     title: "CosmWasm",
     description: "User guide for CosmWasm smart contract developers",
     head: [['link', {rel: 'icon', href: '/cosmwasm-small.svg'}]],
+    lastUpdated: true,
     themeConfig: {
         logo: '/cosmwasm-small.svg',
         nav: [
+            {text: 'Welcome', link: '/guide/welcome'},
             {
-                text: 'Guide',
+                text: 'CosmWasm Core',
                 items: [
-                    {text: 'Welcome', link: '/guide/welcome'},
+                    {text: 'Introduction', link: '/guide/cosmwasm-core/introduction'},
+                    {text: 'Installation', link: '/guide/cosmwasm-core/installation'},
                     {
-                        text: 'CosmWasm Core',
+                        text: 'Architecture',
                         items: [
-                            {text: 'Introduction', link: '/guide/cosmwasm-core/introduction'},
-                            {text: 'Installation', link: '/guide/cosmwasm-core/installation'},
+                            {text: 'Gas', link: '/guide/cosmwasm-core/architecture/gas'},
                         ]
-                    },
-                ],
-
+                    }
+                ]
             },
         ],
         sidebar: [
+            {text: 'Welcome', link: '/guide/welcome'},
             {
-                text: 'Guide',
+                text: 'CosmWasm Core',
+                collapsed: true,
                 items: [
+                    {text: 'Introduction', link: '/guide/cosmwasm-core/introduction'},
+                    {text: 'Installation', link: '/guide/cosmwasm-core/installation'},
                     {
-                        text: 'Welcome', link: '/guide/welcome'
-                    },
-                    {
-                        text: 'CosmWasm Core',
-                        link: '/guide/cosmwasm-core/introduction',
+                        text: 'Architecture',
                         collapsed: true,
                         items: [
-                            {text: 'Installation', link: '/guide/cosmwasm-core/installation'},
-                            {
-                                text: 'Architecture',
-                                link: '/guide/cosmwasm-core/architecture/architecture',
-                                collapsed: true,
-                                items: [
-                                    {text: 'Gas', link: '/guide/cosmwasm-core/architecture/gas'},
-                                ]
-                            },
+                            {text: 'Gas', link: '/guide/cosmwasm-core/architecture/gas'},
                         ]
                     },
-                ],
+                ]
             },
         ],
         search: {
             provider: 'local'
         }
     },
-    mermaid: {
-        // Refer https://mermaid.js.org/config/setup/modules/mermaidAPI.html#mermaidapi-configuration-defaults for options.
-    },
+    mermaid: {},
     markdown: {
         math: true
     },

README.md

@@ -1,3 +1,32 @@
 # CosmWasm User Guide
 
+**A documentation-focused website for CosmWasm technologies**
+
+## Overview
+
+No matter if you're integrating CosmWasm with a chain, writing smart contracts, or just curious
+about what CosmWasm can do, you'll find everything you need here - from the core and wasmd,
+to storage, testing, IBC, and beyond.
+
+## Website
+
 ### https://cosmwasm.github.io
+
+## How is it made?
+
+The deployed documentation is a [VitePress](https://vitepress.dev/) project hosted on GitHub pages.
+
+## How can I run it locally?
+
+You can just clone this repo and run the following commands:
+
+```shell
+$ npm install
+$ task serve
+```
+
+You will now be able to visit the locally served website at http://localhost:5173/
+
+## How can I contribute?
+
+Clone this repo, commit your changes to a new branch, push and open a new PR.

pages/guide/cosmwasm-core/architecture/architecture.md

@@ -10,7 +10,10 @@ hero:
   actions:
       - theme: brand
         text: Welcome
-        link: /guide/welcome      
+        link: /guide/welcome
+      - theme: alt
+        text: CosmWasm Core
+        link: /guide/cosmwasm-core/introduction      
 
 features:
   - title: Security