X-Git-Url: https://mograsim.net/gitweb/?p=Mograsim.git;a=blobdiff_plain;f=README.md;h=311ac75a16d143908d6b949164d48f490c47ca33;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hb=HEAD;hpb=373b945917f9d573e4b1bd0e97f98b02fb0d9c07

diff --git a/README.md b/README.md
index e69de29b..311ac75a 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,30 @@
+# About Mograsim
+
+Mograsim is a modular, graphical simulator for teaching microprogramming, ISAs and 
+circuit logic in a way that allows for a smooth transition between those levels. 
+
+The aim is to give students a better understanding how these layers blend in a machine, 
+and what the purpose of microprogramming is. In more detail, Mograsim allows:
+
+* Programming and running simple assembler on the machine *(in development)*
+* Defining an ISA (Instruction Set) to use in the assembler *(in development)*
+* Microprogram the CPU to implement the specified ISA
+* View the Circuit Logic operating and executing the microprogram in detail
+
+Mograsim focuses especially on the AMD Am2900 Family microprocessors in a specific 
+16-bit arrangement used by the Technical University of Munich as an example.
+
+**For more information and how to use and install Mograsim, visit https://mograsim.net**
+
+# Getting Started
+
+See https://mograsim.net#_getting_started_with_mograsim
+
+# Building Mograsim
+
+| Branch | Status |
+| ------ | ------ |
+| `master` | ![Java CI](https://github.com/MaisiKoleni/Mograsim/workflows/Java%20CI/badge.svg) |
+| `development` | ![Java CI](https://github.com/MaisiKoleni/Mograsim/workflows/Java%20CI/badge.svg?branch=development) |
+
+See [Building Mograsim](docs/building_mograsim.md)