From a07db8c81ab9bc5edfe3deb3f32899be8472ad90 Mon Sep 17 00:00:00 2001
From: Dmitry Rodichev <noroot@falsetrue.io>
Date: Thu, 10 Oct 2019 00:25:31 +0300
Subject: [PATCH] Update README.md with useful first run info

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

diff --git a/README.md b/README.md
index 080fd05..d4f955d 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,49 @@ tools.
 
 Each folder has a README with more details.
 
+## First run
+
+Everything to run is already inside repo, only you have todo is get submodules and compile
+
+
+* `git clone`
+* `git submodule init && git submodule update`
+* `cd tools/emul && make`
+* `./shell/shell`
+
+After that, you have to see prompt like this:
+
+```
+Initializing filesystem
+Collapse OS
+>
+```
+
+You can execute commands and compile with `zasm` inside this shell: 
+
+```
+> fls
+hello.asm
+ed
+zasm
+readme.txt
+user.h
+> fnew 1 dest
+> fopn 0 hello.asm
+> fopn 1 dest
+> zasm 1 2
+First pass
+user.h
+Second pass
+user.h
+> dest
+Assembled from the shell
+```
+
+Shell commands defined here `kernel/shell.asm` here `kernel/fs_cmds.asm` and here `kernel/blockdev_cmds.asm`
+
+Don't be lazy, take a look at [doc/emulate.md](doc/emulate.md) and whole [doc/](doc) section.
+
 ## Status
 
 The project unfinished but is progressing well! See [Collapse OS' website][web]