From d8691cf178571250ca902ebff639ebfd1dc97a1e Mon Sep 17 00:00:00 2001
From: YannAhlgrim <yann@ahlgrim.net>
Date: Sun, 12 Jul 2026 16:21:32 +0200
Subject: [PATCH] details

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/README.md b/README.md
index 6cca8d0..738644d 100644
--- a/README.md
+++ b/README.md
@@ -3,3 +3,43 @@
 This repository follows the book [Writing an Interpreter in Go](https://interpreterbook.com/) and implements the code in Rust.
 
 [![Writing an Interpreter in Go](html_cover.png)](https://interpreterbook.com/)
+
+## Run
+
+```bash
+cargo run
+```
+
+## Architecture
+
+The interpreter is built in three main stages:
+
+1. **Lexer** — tokenizes the input source code.
+2. **Pratt parser** — builds an AST from the tokens.
+3. **Evaluator** — walks the AST and executes the program.
+
+Additional tests are in `evaluator/tests.rs`.
+
+## Features
+
+- Integers, strings, booleans
+- Arrays and hashes with index access
+- `let` bindings, `return` statements, and `if/else` expressions
+- First-class functions and closures
+
+## Project structure
+
+| Module | Purpose |
+|--------|---------|
+| `lexer` | Tokenizes source input |
+| `parser` | Pratt parser that produces an AST |
+| `ast` | AST node definitions |
+| `object` | Runtime values and environment |
+| `evaluator` | Tree-walking evaluator |
+| `repl` | Interactive REPL |
+
+## Tests
+
+```bash
+cargo test
+```