diff --git a/keyboards/handwired/adept42/readme.md b/keyboards/handwired/adept42/readme.md
index a8821d0279..14cf94a184 100644
--- a/keyboards/handwired/adept42/readme.md
+++ b/keyboards/handwired/adept42/readme.md
@@ -1,5 +1,20 @@
-Adept42
-=======
+# Adept42
 
-A split keyboard with 3x6 vertically staggered keys and 3 thumb keys.
+![Adept42](http://i.imgur.com/c2M3uEU.jpg)
+
+A compact 40% (6x3) ortholinear keyboard kit
+
+* Keyboard Maintainer: [Deon Spengler](https://github.com/deonspengler)
+* Hardware Supported: Pro Micro
+* Hardware Availability:
+
+Make example for this keyboard (after setting up your build environment):
+
+    make handwired/adept42:default
+
+Flash firmware to Pro Micro
+
+    make handwired/adept42:default:avrdude
+
+See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).