diff --git a/Readme.md b/Readme.md index f1dd1be6..ca76a738 100644 --- a/Readme.md +++ b/Readme.md @@ -389,21 +389,16 @@ for a more complex example with tests of blocking reads from the keyboard and what gets printed to the screen -- things we don't typically associate with automated tests. -b) Try skimming the [colorized source code](https://akkartik.github.io/mu). -You should be able to get a pretty good sense for how things work just by -skimming the files in order, skimming the top of each file and ignoring -details lower down. - -c) Try running the tests: +b) Try running the tests: ```shell $ ./mu test ``` -d) Check out [the programming environment](https://github.com/akkartik/mu/tree/master/edit#readme), +c) Check out [the programming environment](https://github.com/akkartik/mu/tree/master/edit#readme), the largest app built so far in Mu. -e) Check out the tracing infrastructure which gives you a maps-like zoomable +d) Check out the tracing infrastructure which gives you a maps-like zoomable UI for browsing Mu's traces: ```shell @@ -415,12 +410,18 @@ UI for browsing Mu's traces: For more details see the [Readme](browse_trace/Readme.md). -f) Look at the `build` scripts. Mu's compilation process is itself designed to +e) Look at the `build` scripts. Mu's compilation process is itself designed to support staged learning. Each of the scripts (`build0`, `build1`, `build2`, etc.) is self-contained and can compile the project by itself. Successive versions add new features and configurability -- and complexity -- to the compilation process. +f) Try skimming the [colorized source code](https://akkartik.github.io/mu). +You should be able to get a pretty good sense for how things work just by +skimming the files in order, skimming the top of each file and ignoring +details lower down. +[Some details on my unconventional approach to organizing projects.](http://akkartik.name/post/four-repos) + **Credits** Mu builds on many ideas that have come before, especially: diff --git a/subx/Readme.md b/subx/Readme.md index 8891e8ee..ecc2a0fa 100644 --- a/subx/Readme.md +++ b/subx/Readme.md @@ -553,6 +553,7 @@ Here's what I've built so far: (pdf; [cached local copy](https://github.com/akkartik/mu/blob/master/subx/cheatsheet.pdf)) * [Concise reference for the x86 ISA](https://c9x.me/x86) * [Intel processor manual](http://www.intel.com/content/dam/www/public/us/en/documents/manuals/64-ia-32-architectures-software-developer-instruction-set-reference-manual-325383.pdf) (pdf) +* [Some details on the unconventional organization of this project.](http://akkartik.name/post/four-repos) ## Inspirations