Tcode-Motion · Tcode-Motion · Aug 18, 2026 · Aug 18, 2026
diff --git a/docs/CompilerArchitecture.md → docs/compiler/architecture.md b/docs/CompilerArchitecture.md → docs/compiler/architecture.md
diff --git a/docs/llvm-backend.md → docs/compiler/llvm-backend.md b/docs/llvm-backend.md → docs/compiler/llvm-backend.md
diff --git a/docs/vm.md → docs/compiler/vm.md b/docs/vm.md → docs/compiler/vm.md
diff --git a/docs/FAQ.md → docs/faq.md b/docs/FAQ.md → docs/faq.md
diff --git a/docs/getting-started.md → docs/getting-started/getting-started.md b/docs/getting-started.md → docs/getting-started/getting-started.md
diff --git a/docs/Installation.md → docs/getting-started/installation.md b/docs/Installation.md → docs/getting-started/installation.md
diff --git a/docs/BestPractices.md → docs/guides/BestPractices.md b/docs/BestPractices.md → docs/guides/BestPractices.md
diff --git a/docs/ExamplesGuide.md → docs/guides/ExamplesGuide.md b/docs/ExamplesGuide.md → docs/guides/ExamplesGuide.md
diff --git a/docs/arrays.md → docs/language/arrays.md b/docs/arrays.md → docs/language/arrays.md
diff --git a/docs/async.md → docs/language/async.md b/docs/async.md → docs/language/async.md
diff --git a/docs/classes.md → docs/language/classes.md b/docs/classes.md → docs/language/classes.md
diff --git a/docs/closures.md → docs/language/closures.md b/docs/closures.md → docs/language/closures.md
diff --git a/docs/multithreading.md → docs/language/concurrency.md b/docs/multithreading.md → docs/language/concurrency.md
diff --git a/docs/syntax.md → docs/language/control-flow.md b/docs/syntax.md → docs/language/control-flow.md
diff --git a/docs/exceptions.md → docs/language/error-handling.md b/docs/exceptions.md → docs/language/error-handling.md
diff --git a/docs/functions.md → docs/language/functions.md b/docs/functions.md → docs/language/functions.md
diff --git a/docs/imports.md → docs/language/imports-exports.md b/docs/imports.md → docs/language/imports-exports.md
diff --git a/docs/inheritance.md → docs/language/inheritance.md b/docs/inheritance.md → docs/language/inheritance.md
diff --git a/docs/interfaces.md → docs/language/interfaces.md b/docs/interfaces.md → docs/language/interfaces.md
diff --git a/docs/maps.md → docs/language/maps.md b/docs/maps.md → docs/language/maps.md
diff --git a/docs/ownership.md → docs/language/memory.md b/docs/ownership.md → docs/language/memory.md
diff --git a/docs/operators.md → docs/language/operators.md b/docs/operators.md → docs/language/operators.md
diff --git a/docs/LanguageGuide.md → docs/language/overview.md b/docs/LanguageGuide.md → docs/language/overview.md
diff --git a/docs/packages.md → docs/language/packages.md b/docs/packages.md → docs/language/packages.md
diff --git a/docs/pattern-matching.md → docs/language/pattern-matching.md b/docs/pattern-matching.md → docs/language/pattern-matching.md
diff --git a/docs/traits.md → docs/language/traits.md b/docs/traits.md → docs/language/traits.md
diff --git a/docs/types.md → docs/language/types.md b/docs/types.md → docs/language/types.md
@@ -1,5 +1,7 @@
 # Types in TechScript
 
+**Status: Implemented**
+
 TechScript is dynamically typed. Variables do not have fixed types, but values do.
 
 ---
@@ -62,7 +64,7 @@ configs = {
 
 ## 🔴 Custom Types
 
-### Class / Model
+### Class
 Objects instantiated using `class` and `new`:
 ```txs
 class Dog

diff --git a/docs/variables.md → docs/language/variables.md b/docs/variables.md → docs/language/variables.md
@@ -1,5 +1,7 @@
 # Variables in TechScript
 
+**Status: Implemented**
+
 Variables in TechScript are dynamically typed, and they are defined on their first assignment.
 
 ---

diff --git a/docs/APIReference.md → docs/reference/APIReference.md b/docs/APIReference.md → docs/reference/APIReference.md
diff --git a/docs/StdlibReference.md → docs/reference/StdlibReference.md b/docs/StdlibReference.md → docs/reference/StdlibReference.md
diff --git a/docs/bytecode.md → docs/specification/bytecode.md b/docs/bytecode.md → docs/specification/bytecode.md
diff --git a/docs/ffi.md → docs/specification/ffi.md b/docs/ffi.md → docs/specification/ffi.md
diff --git a/docs/memory-model.md → docs/specification/memory-model.md b/docs/memory-model.md → docs/specification/memory-model.md
diff --git a/docs/cli.md → docs/tooling/cli.md b/docs/cli.md → docs/tooling/cli.md
diff --git a/docs/formatter.md → docs/tooling/formatter.md b/docs/formatter.md → docs/tooling/formatter.md
diff --git a/docs/package-manager.md → docs/tooling/package-manager.md b/docs/package-manager.md → docs/tooling/package-manager.md
diff --git a/docs/testing.md → docs/tooling/test-runner.md b/docs/testing.md → docs/tooling/test-runner.md
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -55,46 +55,50 @@ plugins:
 
 nav:
   - Home: index.md
-  - Getting Started: getting-started.md
-  - Installation: Installation.md
-  - Language Guide:
-    - Variables: variables.md
-    - Types & Operators: types.md
-    - Operators: operators.md
-    - Control Flow & Loops: syntax.md
-    - Functions: functions.md
-    - Closures: closures.md
-    - Arrays: arrays.md
-    - Maps: maps.md
-    - Classes & OOP: classes.md
-    - Inheritance: inheritance.md
-    - Interfaces: interfaces.md
-    - Traits: traits.md
-    - Pattern Matching: pattern-matching.md
-    - Error Handling: exceptions.md
-  - Advanced concepts:
-    - Memory & Ownership: ownership.md
-    - Imports & Modules: imports.md
-    - Packages: packages.md
-    - Multithreading: multithreading.md
-    - Async: async.md
-    - FFI: ffi.md
-  - Architecture & Compiler:
-    - Compiler Architecture: CompilerArchitecture.md
-    - LLVM Backend: llvm-backend.md
-    - Bytecode VM: vm.md
-    - Bytecode Format: bytecode.md
-    - Memory Model: memory-model.md
-  - Toolchain Tools:
-    - CLI Command Reference: cli.md
-    - Formatter (tsfmt): formatter.md
-    - Package Manager (tspm): package-manager.md
-    - Unit Testing: testing.md
+  - Getting Started:
+    - getting-started/getting-started.md
+    - getting-started/installation.md
+  - Language:
+    - language/overview.md
+    - language/variables.md
+    - language/types.md
+    - language/operators.md
+    - language/control-flow.md
+    - language/functions.md
+    - language/closures.md
+    - language/classes.md
+    - language/inheritance.md
+    - language/interfaces.md
+    - language/traits.md
+    - language/pattern-matching.md
+    - language/error-handling.md
+    - language/memory.md
+    - language/arrays.md
+    - language/maps.md
+    - language/imports-exports.md
+    - language/packages.md
+    - language/concurrency.md
+    - language/async.md
+  - Specification:
+    - specification/ffi.md
+    - specification/bytecode.md
+    - specification/memory-model.md
+  - Compiler:
+    - compiler/architecture.md
+    - compiler/llvm-backend.md
+    - compiler/vm.md
+  - Tooling:
+    - tooling/cli.md
+    - tooling/formatter.md
+    - tooling/package-manager.md
+    - tooling/test-runner.md
+  - Reference:
+    - reference/APIReference.md
+    - reference/StdlibReference.md
+  - Guides:
+    - guides/ExamplesGuide.md
+    - guides/BestPractices.md
   - Resources:
-    - API Reference: APIReference.md
-    - Stdlib Reference: StdlibReference.md
-    - Examples Guide: ExamplesGuide.md
-    - Best Practices: BestPractices.md
-    - FAQ: FAQ.md
-    - Release Notes: ReleaseNotes.md
-    - Roadmap: Roadmap.md
+    - faq.md
+    - ReleaseNotes.md
+    - Roadmap.md