added DocsPage, improved navbar with dynamic height handling, MathJax integration, new TOC features, and extensive markdown processing

docs/class_reference.md

@@ -1,24 +0,0 @@
-# Classes
-
-## Declaring
-
-    class Foo1
-    class Foo2() // same, empty constructor
-    class Foo3() { // full
-    }
-    class Foo4 { // Only body
-    }
-
-```
-class_declaration = ["abstract",] "class" [, constructor] [, body]
-constructor = "(", [field [, field]] ")
-field = [visibility ,] [access ,] name [, typedecl]
-body = [visibility] ("var", vardecl) | ("val", vardecl) | ("fun", fundecl)
-visibility = "private" | "protected" | "internal"
-```
-
-### Abstract classes
-
-Contain one pr more abstract methods which must be implemented; though they
-can have constructors, the instances of the abstract classes could not be
-created independently

docs/development/String.md

@@ -1,3 +1,5 @@
+[//]: # (excludeFromIndex)
+
 # String
 
 # This document is for developer notes only

docs/development/including_modules.md

@@ -1,5 +1,7 @@
 # Modules inclusion
 
+[//]: # (excludeFromIndex)
+
 Module is, at the low level, a statement that modifies a given context by adding
 here local and exported symbols, performing some tasks and even returning some value
 we don't need for now.

docs/development/scope_resolution.md

@@ -1,3 +1,4 @@
+[//]: # (excludeFromIndex)
 
 
 Provide:

docs/perf_guide.md

@@ -1,6 +1,8 @@
 
 This document explains how to enable and measure the performance optimizations added to the Lyng interpreter. The focus is JVM‑first with safe, flag‑guarded rollouts and quick A/B testing. Other targets (JS/Wasm/Native) keep conservative defaults until validated.
 
+[//]: # (excludeFromIndex)
+
 ## Overview
 
 Optimizations are controlled by runtime‑mutable flags in `net.sergeych.lyng.PerfFlags`, initialized from platform‑specific static defaults `net.sergeych.lyng.PerfDefaults` (KMP `expect/actual`).

docs/perf_plan_jvm.md

@@ -1,5 +1,7 @@
 # JVM-only Performance Optimization Plan (Saved)
 
+[//]: # (excludeFromIndex)
+
 Date: 2025-11-10 22:14 (local)
 
 This document captures the agreed next optimization steps so we can restore the plan later if needed.

docs/tutorial.md

@@ -1,3 +1,22 @@
+# Lyng tutorial
+
+Lyng is a very simple language, where we take only most important and popular features from
+other scripts and languages. In particular, we adopt _principle of minimal confusion_[^1].
+In other word, the code usually works as expected when you see it. So, nothing unusual.
+
+__Other documents to read__ maybe after this one:
+
+- [Advanced topics](advanced_topics.md), [declaring arguments](declaring_arguments.md)
+- [OOP notes](OOP.md), [exception handling](exceptions_handling.md)
+- [math in Lyng](math.md)
+- [time](time.md) and [parallelism](parallelism.md)
+- [parallelism] - multithreaded code, coroutines, etc.
+- Some class
+  references: [List], [Set], [Map], [Real], [Range], [Iterable], [Iterator], [time manipulation](time.md), [Array], [RingBuffer], [Buffer].
+- Some samples: [combinatorics](samples/combinatorics.lyng.md), national vars and
+  loops: [сумма ряда](samples/сумма_ряда.lyng.md). More at [samples folder](samples)
+
+# Expressions
 
 Everything is an expression in Lyng. Even an empty block:
 
@@ -1465,3 +1484,5 @@ Notes:
 - Resolution order uses C3 MRO (active): deterministic, monotonic order suitable for diamonds and complex hierarchies. Example: for `class D() : B(), C()` where both `B()` and `C()` derive from `A()`, the C3 order is `D → B → C → A`. The first visible match wins.
 - `private` is visible only inside the declaring class; `protected` is visible from the declaring class and any of its transitive subclasses. Qualification (`this@Type`) or casts do not bypass visibility.
 - Safe‑call `?.` works with `as?` for optional dispatch.
+
+To get details on OOP in Lyng, see [OOP notes](oop.md).