vision docs
Welcome
Vision is a small, legible systems language. This is where you learn it.
What it is
Vision is a natural language systems programming language — it reads like plain sentences and compiles to C. It has automatic memory management and is small enough to hold in your head.
The central idea: legibility is not a luxury. When code reads like sentences, more people can understand it, maintain it, and feel confident enough to change it. The wall between "people who code" and "people who don't" was never real — it was mostly a pile of symbols nobody ever explained.
Vision spells things out. Words, not symbols. Indentation makes blocks. Every possible failure is handled explicitly. Every side effect is marked. The language refuses to compile until these things are true.
Who it's for
Vision is for people who want to write software that works and can be read later — by themselves, or by someone else. It suits systems work: tools, daemons, servers, anything that needs to be fast and reliable without being mysterious.
It is also for people who have been put off by other languages. If you looked at C and saw noise, or looked at Rust and felt the weight of it, Vision is a different path to the same destination. The language was built with accessibility as a founding value, not an afterthought.
Your first program
Every Vision program has an entry point called begin:
to begin: say "hello"
That is real, runnable Vision. to begin: opens the entry point.
say writes a line of output. Indentation marks the block.
No braces, no semicolons, no boilerplate.
Where next
Start with Reading Vision — a quick pass through how the language looks on the page and why it's arranged the way it is. From there, work through the grammar, values, and control flow sections at whatever pace suits you. A complete program pulls it all together when you're ready.