The Guide

One topic per chapter, each complete: where the Tour shows the common case, the Guide covers every form, rule and exception, with the reasons where they are not obvious. The chapters can be read in any order. Each one links to the matching part of the Reference, the specification, for the exact rules.

1. Syntax: layout, comments, names, and the words Luce reserves
2. Types and values: the built-in types, inference, equality, printing and conversions
3. Text and bytes: str, formatted strings, and bytes
4. Collections: list, map, set and tuples, with every operation
5. Expressions: arithmetic, comparison, membership, precedence and assignment
6. Control flow: if, loops, labels, match and its patterns, with
7. Functions: parameters, methods, lambdas and closures
8. Structs and enums: value types in full
9. Classes and memory: objects, lifetime, cycles, weak references and resources
10. Optionals and errors: T?, T!, catch, Result, traps
11. Interfaces and generics: interfaces, type parameters, the built-in interfaces
12. Workers: running work in parallel
13. Modules and packages: files, imports, manifests, dependencies and publishing
14. Testing: test blocks and how they run
15. The standard library: what luce-std offers a Luce program
16. Luce and Base: Base modules, what crosses between the languages, handles
17. Tools: the luce command, diagnostics, traps, builds and formatting

Gotchas collects the surprises, each with a link to where it is explained.