Documentation

Use these guides to learn the language, understand the runtime, and contribute with confidence.

Reference and playground

• doc.mu-lang.dev — the standard library reference: every host builtin, every prelude name, and every module, with search. Generated from the library’s own source, so it is the same text mu-doc prints in a terminal.
• play.mu-lang.dev — run mu in the browser, with the examples from the repository already loaded.

Repository

• Source code: git.mills.io/prologic/mu

Getting started

• Get started — quick CLI setup and workflows
• docs/GettingStarted.md — tutorial-style introduction

Language and runtime

• Language tour — syntax and semantics tour
• Runtime — VM and native backend overview
• Specification — the whole language, compactly, on one page
• docs/Grammar.md — formal grammar
• docs/Specification.md — full language contract

Standard library

• Standard library — stdlib layers and modules
• doc.mu-lang.dev — the full API reference, module by module
• docs/StdlibGuidelines.md — conventions and growth rules

Advanced topics

• Macros — code as a value, and macros as functions
• docs/Macros.md + docs/MacroTutorial.md
• Concurrency — tasks and channels
• FFI — foreign function interface

Design notes

• docs/Zen.md — philosophy, and what mu trades away
• docs/Design.md — value model, scoping, control flow
• docs/Comparison.md — how mu differs from Python, Go and friends
• docs/DecimalLiteralsRFC.md — decimal literals and the __ops operator protocol
• docs/MacroOverhaulRFC.md — why macros became functions over code values

Implementation + roadmap

• docs/Implementation.md — compiler and VM architecture
• docs/ir.md — IR and assembler details
• docs/NativeBackendGuide.md — keeping the native backends aligned with the VM
• docs/Testing.md — what is covered, and how
• docs/Roadmap.md — staged plan and acceptance criteria

Next steps

• Start with the Get Started guide.
• Read the language tour for core syntax.
• Use the runtime guide to understand execution.