Update HypnoScript documentation with comprehensive core concepts, quick start guide, and detailed language features. Enhance examples and clarify syntax, control structures, and built-in functions. Improve overall readability and organization of content, ensuring a better onboarding experience for new users.

Author: JosunLP

hypnoscript-docs/docs/.vitepress/config.mts

@@ -125,7 +125,7 @@ export default defineConfig({
         items: [
           { text: 'Sprachreferenz', link: '/language-reference/syntax' },
           { text: 'Builtin-Funktionen', link: '/builtins/overview' },
-          { text: 'CLI', link: '/cli/overview' },
+          { text: 'CLI Kommandos', link: '/cli/commands' },
           { text: 'Runtime', link: '/reference/runtime' },
         ],
       },
@@ -149,159 +149,44 @@ export default defineConfig({
           items: [
             { text: 'Installation', link: '/getting-started/installation' },
             { text: 'Quick Start', link: '/getting-started/quick-start' },
-            { text: 'Grundkonzepte', link: '/getting-started/core-concepts' },
             { text: 'Hello World', link: '/getting-started/hello-world' },
+            { text: 'Grundkonzepte', link: '/getting-started/core-concepts' },
             { text: 'CLI Basics', link: '/getting-started/cli-basics' },
           ],
         },
         {
           text: 'Sprachreferenz',
-          collapsed: true,
+          collapsed: false,
           items: [
-            { text: 'Syntax', link: '/language-reference/syntax' },
-            { text: 'Variablen', link: '/language-reference/variables' },
+            { text: 'Syntax & Struktur', link: '/language-reference/syntax' },
+            { text: 'Variablen & Typen', link: '/language-reference/variables' },
             { text: 'Operatoren', link: '/language-reference/operators' },
-            {
-              text: 'Kontrollstrukturen',
-              link: '/language-reference/control-flow',
-            },
-            { text: 'Funktionen', link: '/language-reference/functions' },
-            { text: 'Arrays', link: '/language-reference/arrays' },
-            { text: 'Records', link: '/language-reference/records' },
+            { text: 'Kontrollfluss', link: '/language-reference/control-flow' },
+            { text: 'Funktionen & Trigger', link: '/language-reference/functions' },
             { text: 'Sessions', link: '/language-reference/sessions' },
-            { text: 'Tranceify', link: '/language-reference/tranceify' },
-            { text: 'Assertions', link: '/language-reference/assertions' },
+            { text: 'Schlüsselwörter', link: '/language-reference/_keywords-reference' },
           ],
         },
         {
-          text: 'Builtin-Funktionen',
-          collapsed: true,
+          text: 'Standardbibliothek',
+          collapsed: false,
           items: [
-            { text: 'Übersicht', link: '/builtins/overview' },
-            { text: 'Array-Funktionen', link: '/builtins/array-functions' },
-            { text: 'String-Funktionen', link: '/builtins/string-functions' },
-            { text: 'Math-Funktionen', link: '/builtins/math-functions' },
-            { text: 'System-Funktionen', link: '/builtins/system-functions' },
-            { text: 'Zeit & Datum', link: '/builtins/time-date-functions' },
-            { text: 'Datei-Funktionen', link: '/builtins/file-functions' },
-            { text: 'Utility-Funktionen', link: '/builtins/utility-functions' },
-            { text: 'Hashing & Encoding', link: '/builtins/hashing-encoding' },
-            { text: 'Statistik-Funktionen', link: '/builtins/statistics-functions' },
-            { text: 'Validierungs-Funktionen', link: '/builtins/validation-functions' },
-            { text: 'Hypnotic Functions', link: '/builtins/hypnotic-functions' },
-            { text: 'Performance-Funktionen', link: '/builtins/performance-functions' },
-            { text: 'Dictionary-Funktionen', link: '/builtins/dictionary-functions' },
-            { text: 'Netzwerk-Funktionen', link: '/builtins/network-functions' },
+            { text: 'Builtin-Übersicht', link: '/builtins/overview' },
           ],
         },
         {
-          text: 'CLI Tools',
-          collapsed: true,
+          text: 'CLI',
+          collapsed: false,
           items: [
-            { text: 'Übersicht', link: '/cli/overview' },
+            { text: 'Überblick', link: '/cli/overview' },
             { text: 'Befehle', link: '/cli/commands' },
-            { text: 'Konfiguration', link: '/cli/configuration' },
-            { text: 'Testing', link: '/cli/testing' },
-            { text: 'Debugging', link: '/cli/debugging' },
-            { text: 'Erweiterte Befehle', link: '/cli/advanced-commands' },
-            { text: 'Enterprise Features', link: '/cli/enterprise-features' },
-          ],
-        },
-        {
-          text: 'Testing',
-          collapsed: true,
-          items: [
-            { text: 'Überblick', link: '/testing/overview' },
-            { text: 'Assertions', link: '/testing/assertions' },
-            { text: 'Best Practices', link: '/testing/best-practices' },
-            { text: 'Fixtures', link: '/testing/fixtures' },
-            { text: 'Performance', link: '/testing/performance' },
-            { text: 'Reporting', link: '/testing/reporting' },
-          ],
-        },
-        {
-          text: 'Debugging',
-          collapsed: true,
-          items: [
-            { text: 'Überblick', link: '/debugging/overview' },
-            { text: 'Debug-Modus', link: '/debugging/debug-mode' },
-            { text: 'Breakpoints', link: '/debugging/breakpoints' },
-            { text: 'Tools', link: '/debugging/tools' },
-            { text: 'Troubleshooting', link: '/debugging/troubleshooting' },
-            { text: 'Best Practices', link: '/debugging/best-practices' },
-            { text: 'Performance', link: '/debugging/performance' },
-          ],
-        },
-        {
-          text: 'Error Handling',
-          collapsed: true,
-          items: [
-            { text: 'Überblick', link: '/error-handling/overview' },
-            { text: 'Fehlerbehandlung', link: '/error-handling/basics' },
-            { text: 'Häufige Fehler', link: '/error-handling/common-errors' },
-          ],
-        },
-        {
-          text: 'Enterprise',
-          collapsed: true,
-          items: [
-            { text: 'Überblick', link: '/enterprise/overview' },
-            { text: 'Features', link: '/enterprise/features' },
-            { text: 'Security', link: '/enterprise/security' },
-            { text: 'Architecture', link: '/enterprise/architecture' },
-            { text: 'Integration', link: '/enterprise/integration' },
-            { text: 'Monitoring', link: '/enterprise/monitoring' },
-            { text: 'Debugging', link: '/enterprise/debugging' },
-            { text: 'API Management', link: '/enterprise/api-management' },
-            { text: 'Messaging', link: '/enterprise/messaging' },
-            { text: 'Datenbank', link: '/enterprise/database' },
-            { text: 'Backup & Recovery', link: '/enterprise/backup-recovery' },
-          ],
-        },
-        {
-          text: 'Referenzen',
-          collapsed: true,
-          items: [
-            { text: 'Runtime', link: '/reference/runtime' },
-            { text: 'Compiler', link: '/reference/compiler' },
-            { text: 'Interpreter', link: '/reference/interpreter' },
-            { text: 'API', link: '/reference/api' },
-          ],
-        },
-        {
-          text: 'Tutorial Extras',
-          collapsed: true,
-          items: [
-            { text: 'Performance', link: '/tutorial-extras/performance' },
-            {
-              text: 'Dokumentations-Versionen',
-              link: '/tutorial-extras/manage-docs-versions',
-            },
-            { text: 'Lokalisierung', link: '/tutorial-extras/translate-your-site' },
-          ],
-        },
-        {
-          text: 'Beispiele',
-          collapsed: true,
-          items: [
-            { text: 'Einstieg', link: '/examples/basic-examples' },
-            { text: 'Array-Beispiele', link: '/examples/array-examples' },
-            { text: 'String-Beispiele', link: '/examples/string-examples' },
-            { text: 'System-Beispiele', link: '/examples/system-examples' },
-            { text: 'Math-Beispiele', link: '/examples/math-examples' },
-            { text: 'Utility-Beispiele', link: '/examples/utility-examples' },
-            {
-              text: 'Therapeutische Beispiele',
-              link: '/examples/therapeutic-examples',
-            },
-            { text: 'CLI Workflows', link: '/examples/cli-workflows' },
           ],
         },
         {
-          text: 'Entwicklung',
-          collapsed: true,
+          text: 'Referenz',
+          collapsed: false,
           items: [
-            { text: 'Debugging-Prozesse', link: '/development/debugging' },
+            { text: 'Runtime-Architektur', link: '/reference/runtime' },
           ],
         },
       ],

hypnoscript-docs/docs/cli/advanced-commands.md

@@ -2,6 +2,17 @@
 title: Advanced CLI Commands
 ---
 
-# Advanced CLI Commands
+Die HypnoScript CLI hält die Zahl der Subcommands bewusst klein. Es gibt aktuell keine versteckten oder „fortgeschrittenen“ Befehle – stattdessen kombinierst du die vorhandenen Tools flexibel.
 
-This page will document advanced CLI commands. Content coming soon.
+## Nützliche Kombinationen
+
+- **Syntax + Ausführung:** `hypnoscript check file.hyp && hypnoscript run file.hyp --debug`
+- **WASM-Pipeline:** `hypnoscript compile-wasm file.hyp && wat2wasm file.wat`
+- **AST-Vergleich:** `hypnoscript parse file.hyp > ast.log`
+
+## Alias-Ideen
+
+- `alias hrun='hypnoscript run --debug'`
+- `function hcheck() { hypnoscript check "$1" && hypnoscript run "$1"; }`
+
+Weitere Befehle findest du auf der Seite [CLI-Befehle](./commands).