diff --git a/src/Documentation.ts b/src/Documentation.ts
index 67ba5a9..2014f56 100644
--- a/src/Documentation.ts
+++ b/src/Documentation.ts
@@ -1,21 +1,21 @@
 import { type Editor } from "./main";
-import { introduction } from "./documentation/introduction";
+import { introduction } from "./documentation/basics/welcome";
+import { software_interface } from "./documentation/basics/interface";
+import { shortcuts } from "./documentation/basics/keyboard";
+import { code } from "./documentation/basics/code";
+import { mouse } from "./documentation/basics/mouse";
 import { oscilloscope } from "./documentation/oscilloscope";
 import { synchronisation } from "./documentation/synchronisation";
 import { samples } from "./documentation/samples";
 import { chaining } from "./documentation/chaining";
-import { software_interface } from "./documentation/interface";
 import { interaction } from "./documentation/interaction";
 import { time } from "./documentation/time";
 import { linear_time } from "./documentation/linear_time";
 import { cyclical_time } from "./documentation/cyclical_time";
 import { long_forms } from "./documentation/long_forms";
 import { midi } from "./documentation/midi";
-import { code } from "./documentation/code";
 import { about } from "./documentation/about";
 import { sound } from "./documentation/engine";
-import { shortcuts } from "./documentation/keyboard";
-import { mouse } from "./documentation/mouse";
 import { patterns } from "./documentation/patterns";
 import { functions } from "./documentation/functions";
 import { variables } from "./documentation/variables";
diff --git a/src/documentation/code.ts b/src/documentation/basics/code.ts
similarity index 97%
rename from src/documentation/code.ts
rename to src/documentation/basics/code.ts
index 4415a67..07ce4ab 100644
--- a/src/documentation/code.ts
+++ b/src/documentation/basics/code.ts
@@ -1,5 +1,5 @@
-import { type Editor } from "../main";
-import { makeExampleFactory, key_shortcut } from "../Documentation";
+import { type Editor } from "../../main";
+import { makeExampleFactory, key_shortcut } from "../../Documentation";
 
 export const code = (application: Editor): string => {
   const makeExample = makeExampleFactory(application);
diff --git a/src/documentation/interface.ts b/src/documentation/basics/interface.ts
similarity index 97%
rename from src/documentation/interface.ts
rename to src/documentation/basics/interface.ts
index ba22351..13f0cd5 100644
--- a/src/documentation/interface.ts
+++ b/src/documentation/basics/interface.ts
@@ -1,5 +1,5 @@
-import { key_shortcut, makeExampleFactory } from "../Documentation";
-import { type Editor } from "../main";
+import { key_shortcut, makeExampleFactory } from "../../Documentation";
+import { type Editor } from "../../main";
 import topos_arch from "./topos_arch.svg";
 import many_universes from "./many_universes.svg";
 
diff --git a/src/documentation/keyboard.ts b/src/documentation/basics/keyboard.ts
similarity index 94%
rename from src/documentation/keyboard.ts
rename to src/documentation/basics/keyboard.ts
index 12db899..adf2dc0 100644
--- a/src/documentation/keyboard.ts
+++ b/src/documentation/basics/keyboard.ts
@@ -1,6 +1,6 @@
-import { key_shortcut } from "../Documentation";
-import { type Editor } from "../main";
-import { makeExampleFactory } from "../Documentation";
+import { key_shortcut } from "../../Documentation";
+import { type Editor } from "../../main";
+import { makeExampleFactory } from "../../Documentation";
 
 export const shortcuts = (app: Editor): string => {
   let makeExample = makeExampleFactory(app);
diff --git a/src/documentation/many_universes.svg b/src/documentation/basics/many_universes.svg
similarity index 100%
rename from src/documentation/many_universes.svg
rename to src/documentation/basics/many_universes.svg
diff --git a/src/documentation/mouse.ts b/src/documentation/basics/mouse.ts
similarity index 95%
rename from src/documentation/mouse.ts
rename to src/documentation/basics/mouse.ts
index c6b99a0..f6ad3fd 100644
--- a/src/documentation/mouse.ts
+++ b/src/documentation/basics/mouse.ts
@@ -1,5 +1,5 @@
-import { type Editor } from "../main";
-import { makeExampleFactory } from "../Documentation";
+import { type Editor } from "../../main";
+import { makeExampleFactory } from "../../Documentation";
 
 export const mouse = (app: Editor): string => {
   let makeExample = makeExampleFactory(app);
diff --git a/src/documentation/topos_arch.svg b/src/documentation/basics/topos_arch.svg
similarity index 100%
rename from src/documentation/topos_arch.svg
rename to src/documentation/basics/topos_arch.svg
diff --git a/src/documentation/introduction.ts b/src/documentation/basics/welcome.ts
similarity index 94%
rename from src/documentation/introduction.ts
rename to src/documentation/basics/welcome.ts
index 13090bb..3844c6b 100644
--- a/src/documentation/introduction.ts
+++ b/src/documentation/basics/welcome.ts
@@ -1,6 +1,6 @@
-import { makeExampleFactory, key_shortcut } from "../Documentation";
-import { type Editor } from "../main";
-import { examples } from "../examples/excerpts";
+import { makeExampleFactory, key_shortcut } from "../../Documentation";
+import { type Editor } from "../../main";
+import { examples } from "../../examples/excerpts";
 
 export const introduction = (application: Editor): string => {
   const makeExample = makeExampleFactory(application);
diff --git a/src/documentation/probabilities.ts b/src/documentation/probabilities.ts
index 14dae0a..f48b4f2 100644
--- a/src/documentation/probabilities.ts
+++ b/src/documentation/probabilities.ts
@@ -9,8 +9,8 @@ export const probabilities = (application: Editor): string => {
 
 There are some simple functions to play with probabilities.
 
-- <ic>rand(min: number, max:number)</ic>: returns a random number between <ic>min</ic> and <ic>max</ic>. Shorthand _r()_.
-- <ic>irand(min: number, max:number)</ic>: returns a random integer between <ic>min</ic> and <ic>max</ic>. Shorthands _ir()_ or _rI()_.
+- <ic>rand(min: number, max:number)</ic>: returns a random number between <ic>min</ic> and <ic>max</ic>. Shorthand <ic>r()</ic>.
+- <ic>irand(min: number, max:number)</ic>: returns a random integer between <ic>min</ic> and <ic>max</ic>. Shorthands <ic>ir()</ic> or <ic>rI()</ic>.
 
 ${makeExample(
     "Bleep bloop, what were you expecting?",
diff --git a/vite.config.js b/vite.config.js
index ffdfc9b..5a088f8 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -26,7 +26,9 @@ const webManifest = {
 const vitePWAconfiguration = {
   devOptions: {
     enabled: true,
+    suppressWarnings: true,
   },
+
   workbox: {
     sourcemap: false,
     cleanupOutdatedCaches: true,