more docs

Author: pelikhan

website/docs/Dev/architecture.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 100
 hide_table_of_contents: true
 ---
 

website/docs/Dev/cli.md

@@ -1,3 +1,8 @@
+---
+sidebar_position: 10
+hide_table_of_contents: true
+---
+
 # Command Line Interface
 
 The DeviceScript command line allows to compile and debug programs from your favorite IDE.

website/docs/Dev/installation.md

@@ -0,0 +1,25 @@
+---
+sidebar_position: 1
+hide_table_of_contents: true
+---
+# Installation
+
+DeviceScript has been designed to gradual adoption. From editing scripts online in the docs, to building customized embedded firmware images.
+This section will get you started at the level of the stack you're looking for.
+
+## Try DeviceScript
+
+You do not need hardware or install any tools to try out DeviceScript. Try editing this sandbox!
+
+```ts
+every(1, () => {
+    console.log(`hello`)
+})
+```
+
+You can edit it directly and press `Run` to load it in the DeviceScript simulator in the documentation.
+You can also click on `Fork` and open the sample in CodeSandbox.
+
+## Try DeviceScript locally
+
+Install the [DeviceScript command line](./cli.md) and use your favorite TypeScript IDE to write your scripts.

website/docs/getting-started/pico-pressure-button.md

@@ -2,9 +2,15 @@
 
 In this guide, you'll use a Raspberry Pi Pico and a pressure sensor to create a mouse button actionable with the mouse.
 
-:::tip
-Don't worry about the necessary hardware yet, you can use DeviceScript simulator get started without it.
-:::
+## Try DeviceScript
+
+You do not need hardware or install any tools to try out DeviceScript. Try editing this sandbox and press `Run`!
+
+```ts
+every(1, () => {
+    console.log(`hello`)
+})
+```
 
 ## Roles
 

website/docs/intro.md

@@ -23,7 +23,6 @@ environments (VM itself compiles to 10kB of code, with the floating point librar
 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`)
 })