1 files changed, 34 insertions, 0 deletions
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..803d9ba
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,34 @@
+# *MIN*imum system
+
+A small set of scripts to build an absolutely minimalist system using
+the `musl` `libc`, `mksh`, the "one true awk", and other tools.
+
+I'm purposely trying to avoid large or complex projects such as Busybox.
+Not that they don't have their place, or that there's anything wrong with
+them, but IMO they take the fun out of it because they have absolutely
+everything you need.  The Linux Kernel will be the glaring exception here.
+
+Currently it's just building a minimal set of tools into `pfx/` eventually
+the scripts will encompass building a virtual machine image with a boot
+loader and all the bells and whistles. ( if I get around to it ha ha )
+
+## Will your system include a compiler?
+
+Probably not, but I've thought about this one, it'd be cool to make it
+"self-hosting" in a sense.
+
+## What Linux distribution are you building this on?
+
+Gentoo at the moment, it should work on any Linux distribution.
+
+## Why?
+
+I want to learn more about how operating systems are built and doing something
+that someone else has already laid out for you ( such as the LFS project ) is
+just too tedious and boring for me, I'd rather do something different.
+
+
+## The process so far:
+
+Run `scripts/get_sources.sh` and then `scripts/build.sh` It's rather important
+to run them from the `min` directory so the paths and imports will be correct.