Interton User Documentation

Public user-facing documentation for the current Interton beta line.

---

Overview

This directory is the main documentation hub for the current Interton beta. It covers the external language surface: syntax, types, CLI behavior, standard modules, Mermaid orchestration, and practical example-oriented usage.

Important

Current target version: Interton beta-v_.7.4

Quick Check

Run this before reading deeper:

intertonc --version
intertonc --help

Expected version marker:

Interton compiler beta-v_.7.4

Start Here

Need	Recommended entry
Main reading map	RU Handbook or EN Handbook
First working program	RU Quick Start or EN Quick Start
CLI modes and flags	RU CLI Run Modes or EN CLI Run Modes
Built-in modules and callable API	RU Standard Library or EN Standard Library
Mermaid system surface	RU Mermaid Spec or EN Mermaid Spec
Full current language reference	RU Language Spec or EN Language Spec
User-visible changes since baseline	Patch Notes

Reading Tracks

Русская Документация

Рекомендуемый порядок чтения:

1. ru/00-handbook.md - главная точка входа и карта документации
2. ru/00-quick-start.md - первый запуск, минимальные программы, проверенные примеры
3. ru/01-language-tour.md - компактный обзор языковой поверхности
4. ru/02-types-and-data.md - литералы, массивы, кортежи, optional, объектные данные
5. ru/03-expressions-and-operators.md - выражения, приоритеты, присваивания, диапазоны
6. ru/04-control-flow-and-functions.md - управляющие конструкции, call, procedure, лямбды, async
7. ru/05-modules-ffi-and-metadata.md - модули, using, foreign-блоки, metadata, domain_entity
8. ru/06-logic-tunnel-toned-refocus.md - логический слой, tunnel, toned, refocus
9. ru/07-quantum-interference-and-ray.md - квантовые, interference и ray-ориентированные API
10. ru/08-recipes-and-patterns.md - короткие прикладные рецепты
11. ru/09-cli-run-modes.md - режимы компилятора, feature-флаги, execution profiles
12. ru/11-standard-library-reference.md - встроенные модули и callable API
13. ru/12-mermaid-system-spec.md - cluster, deep, struct, temporal, causal, meta, messaging
14. ru/13-current-language-spec.md - сводная спецификация текущей beta-ветки языка

English Track

Recommended reading order:

1. en/00-handbook.md - main entry point and reading map
2. en/00-quick-start.md - first run, minimal programs, validated examples
3. en/01-language-tour.md - compact map of the language surface
4. en/02-types-and-data.md - literals, arrays, tuples, optional, object-like data
5. en/03-expressions-and-operators.md - expressions, precedence, assignment, ranges
6. en/04-control-flow-and-functions.md - control flow, call, procedure, lambdas, async
7. en/05-modules-ffi-and-metadata.md - modules, using, foreign blocks, metadata, domain_entity
8. en/06-logic-tunnel-toned-refocus.md - logic layer, tunnel, toned, refocus
9. en/07-quantum-interference-and-ray.md - quantum, interference, ray-oriented APIs
10. en/08-recipes-and-patterns.md - short practical templates
11. en/09-cli-run-modes.md - compiler modes, feature flags, execution profiles
12. en/11-standard-library-reference.md - built-in modules and callable API
13. en/12-mermaid-system-spec.md - cluster, deep, struct, temporal, causal, meta, messaging
14. en/13-current-language-spec.md - consolidated current beta language specification

Release And Project Docs

• PATCH_NOTES.md - user-facing fixes, improvements, performance notes, and in-progress items
• SECURITY.md - vulnerability reporting and artifact integrity guidance
• CONTRIBUTING.md - contribution flow
• CODE_OF_CONDUCT.md - community behavior rules
• License.md - licensing terms

Notes

• The beta language surface is still evolving; syntax, modules, and CLI behavior may change between releases.
• The Russian and English tracks follow the same compact structure and cover the same main topics.
• This folder is written for application developers, integrators, and users validating the current beta line in practice.