diff --git a/README.md b/README.md
index 4bfe2e1d55d242058358e821212f0c29adbe646f..892c8f6bdf275ce6c384e4ff53a84f9921a69f0d 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,31 @@
-It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [link to Google!](http://google.com)
\ No newline at end of file
+
+# Are We Embedded Yet 
+## D7018E - Special Studies in Embedded Systems
+
+
+The course will be given as a self study course with a set of introductional seminars and accompanying mandatory assignments, followed by a larger assigmnent (project). The project can be carried out individually or in groups dependent on size. Grading will be individual, based on agreed requirements between the student and the teacher, showing understanding and abilities regarding (in order of introduction):
+
+1. The Rust ecosystem.
+ Rustup (stable vs nightly), crates and toml files, cargo, rustc, llvm, gdb/lldb (and additional tooling rls, rustfmt, racer, xargo etc.) The Rust core and standard library. Building, bebugging/testing, docmunenting and publishing Rust applications and libraries.  
+
+
+2. Simple applications in Rust
+
+Prmitive types, tupels, structs, enums, etc. Flow control and functions. Marco usage.
+
+3. Rust features
+
+Closures (and higher order functions). 
+
+
+
+ Trait definitions and implementations. 
+
+### The Rust Memory Model
+
+Theoretical underpinning, as well as impact to both memory safatey and code generation. Exterior (inherited) and interior mutability. Move vs. borrow. 
+
+
+
+It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [link to Google!](http://google.com)
+