diff --git a/README.md b/README.md
index f2c0983f7b..4a95388127 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,11 @@ Important note - we now use submodules:
 
 `git submodule update --init`
 
+# What do we have here?
+ * [Firmware](/firmware) Source code for open source engine control unit for stm32 chips
+ * [Hardware](/hardware) KiCAD files for all our PCBs
+ * [Unit Tests]()
+
 
 # External Links
 
diff --git a/hardware/frankenso/readme.md b/hardware/frankenso/readme.md
new file mode 100644
index 0000000000..876a620c9a
--- /dev/null
+++ b/hardware/frankenso/readme.md
@@ -0,0 +1,7 @@
+Our best ECU board
+
+[Online manual](https://rusefi.com/wiki/index.php?title=Manual:Hardware_Frankenso_board)
+
+[Forum thread]()https://rusefi.com/forum/viewtopic.php?f=4&t=569)
+
+[Known_issues.txt](known_issues.txt)
diff --git a/hardware/readme.html b/hardware/readme.md
similarity index 68%
rename from hardware/readme.html
rename to hardware/readme.md
index 91bb5a88a4..2657f1008c 100644
--- a/hardware/readme.html
+++ b/hardware/readme.md
@@ -1,15 +1,11 @@
 
 
-The most interesting folder here is frankenso - that's rusEfi most useful board
+The most interesting folder here is [Frankenso](frankenso/) - that's rusEfi most useful board
 
-<br>
-<br>
 
 Some vehicle-specific connector boards are also pretty nice if you want to keep original harness intact
-<br>
-<br>
 
 See http://rusefi.com/wiki/index.php?title=Hardware:OEM_connectors
-<br>
+
 See http://rusefi.com/forum/viewtopic.php?f=4&t=260