tweaks to docs

website/docs/Dev/_category_.json

@@ -1,8 +1,4 @@
 {
-  "label": "Developer Experience",
-  "position": 3,
-  "link": {
-    "type": "generated-index",
-    "description": "How the editors work."
-  }
+    "label": "Developer",
+    "position": 3
 }

website/docs/Language/_category_.json

@@ -1,9 +1,5 @@
 {
     "label": "Language",
     "position": 2,
-    "collapsible": true,
-    "link": {
-        "type": "generated-index",
-        "description": "DeviceScript Language and Runtime reference."
-    }
+    "collapsible": true
 }

website/docs/Language/index.md

@@ -0,0 +1,6 @@
+# DeviceScript Language
+
+DeviceScript is a programming language for scripting [Jacdac](https://aka.ms/jacdac) services in embedded devices.
+
+It has JavaScript-like syntax and is compiled to a custom VM bytecode, which can run in very constrained
+environments.

website/docs/intro.md

@@ -17,3 +17,14 @@ environments (VM itself compiles to 10kB of code, with the floating point librar
 * small memory (RAM) footprint
 * small code (flash) footprint
 * leave space for extensions in future
+
+## Live documentation
+
+Most code examples can be loaded in the side-editor by clicking the `Run` button; or in other cloud-based virtual machine by hovering on the source and clicking on the apprioriate button.
+
+```ts
+console.log(`click run to load this program in a DeviceScript simulator`)
+every(1, () => {
+    console.log(`hello`)
+})
+```

website/docusaurus.config.js

@@ -42,6 +42,7 @@ async function createConfig() {
                 /** @type {import('@docusaurus/preset-classic').Options} */
                 ({
                     docs: {
+                        routeBasePath: '/',
                         sidebarPath: require.resolve("./sidebars.js"),
                         remarkPlugins: [],
                     },
@@ -73,7 +74,7 @@ async function createConfig() {
                             type: "doc",
                             docId: "intro",
                             position: "left",
-                            label: "Reference",
+                            label: "Docs",
                         },
                         {
                             href: "https://github.com/microsoft/devicescript/",