Skip to content

Commit e4ffbbf

Browse files
committed
Documented Docker-first beginner ramp-up
1 parent 1b0270f commit e4ffbbf

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,15 @@ If your host toolchain does not match the Docker-verified environment, open the
7979
make docker-shell
8080
```
8181

82+
## Beginner Ramp-Up
83+
84+
If you are new to ThunderOS, use this order:
85+
86+
1. Run `make docker-verify` first so you start from the same release-grade path used for public verification.
87+
2. Use `make qemu` only after the Docker path passes, so host-specific differences do not confuse the first run.
88+
3. Read [ROADMAP.md](ROADMAP.md) and `docs/source/development.rst` before making subsystem changes.
89+
4. Treat `external/userland/` as a separate concern from kernel work unless your change explicitly crosses that boundary.
90+
8291
## Setup Contract
8392

8493
ThunderOS has two supported public setup paths:

0 commit comments

Comments
 (0)