att

Author: matesmoutinho

template/docs/build.md

@@ -1,34 +1,81 @@
-### Building from Scratch
-if you want to build the project from the repo, just install [Darwin](https://github.com/OUIsolutions/Darwin) on version 0.020 with:
-### Linux Build
+# Building from Source
+
+This guide explains how to build **PROJECT_NAME.lua** from the source code.
+If you just want to use the library, grab the pre-built release from the [Releases](#) page instead.
+
+---
+
+## Prerequisites
+
+This project uses [Darwin](https://github.com/OUIsolutions/Darwin) as its build tool.
+Darwin is a lightweight build runner — you need to install it before you can build anything.
+
+> **Required Darwin version:** `0.020`
+
+---
+
+## Step 1 — Install Darwin
+
+Choose the command that matches your operating system and paste it into your terminal.
+
+### Linux
+
 ```bash
-curl -L https://github.com/OUIsolutions/Darwin/releases/download/REQUIRED_DARWIN_VERSION/darwin.c -o darwin.c && gcc darwin.c -o darwin.out && sudo mv darwin.out /usr/bin/darwin && rm darwin.c   
+curl -L https://github.com/OUIsolutions/Darwin/releases/download/REQUIRED_DARWIN_VERSION/darwin.c -o darwin.c \
+  && gcc darwin.c -o darwin.out \
+  && sudo mv darwin.out /usr/bin/darwin \
+  && rm darwin.c
 ```
-### Mac Build
+
+### macOS
+
 ```bash
-curl -L https://github.com/OUIsolutions/Darwin/releases/download/REQUIRED_DARWIN_VERSION/darwin.c -o darwin.c && gcc darwin.c -o darwin.out && sudo mv darwin.out /usr/local/bin/darwin && rm darwin.c
+curl -L https://github.com/OUIsolutions/Darwin/releases/download/REQUIRED_DARWIN_VERSION/darwin.c -o darwin.c \
+  && gcc darwin.c -o darwin.out \
+  && sudo mv darwin.out /usr/local/bin/darwin \
+  && rm darwin.c
 ```
 
-### OTher FOormats
-check the [release](https://github.com/OUIsolutions/Darwin/releases/tag/0.20.0) page for other formats.
+### Other platforms
+
+Check the [Darwin releases page](https://github.com/OUIsolutions/Darwin/releases/tag/0.20.0) for Windows binaries and other formats.
+
+---
+
+## Step 2 — Build the project
 
+Once Darwin is installed, run the following command from the **root of the repository**:
 
-and then you can build the **PROJECT_NAME.lua** with:
 ```bash
 darwin run_blueprint --target all
 ```
-it will generte the **PROJECT_NAME.lua** in the `release/` folder.
 
-### Build
-List available recipes (located in `builds`):
+This will generate **PROJECT_NAME.lua** inside the `release/` folder.
+
+---
+
+## Advanced: Choosing a specific build target
+
+Darwin organises builds into *recipes* (located in the `builds/` folder).
+
+**List all available recipes:**
+
 ```bash
 darwin list
 ```
-Build all:
-```bash
-darwin run_blueprint --target all
-```
-Build a specific recipe:
+
+**Build a specific recipe** (replace `<recipe_name>` with one from the list above):
+
 ```bash
 darwin run_blueprint --target <recipe_name>
-```
+```
+
+---
+
+## Quick reference
+
+| Command | What it does |
+|---|---|
+| `darwin list` | Show all available build recipes |
+| `darwin run_blueprint --target all` | Build everything (outputs to `release/`) |
+| `darwin run_blueprint --target <recipe>` | Build a single specific recipe |