1 files changed, 13 insertions, 5 deletions

diff --git a/keyboards/m10a/readme.md b/keyboards/m10a/readme.md
index 7123e6462..3918ad21b 100644
--- a/keyboards/m10a/readme.md
+++ b/keyboards/m10a/readme.md
@@ -1,13 +1,21 @@
 # Rama Works X Machine Industries M10-A Macropad
 
-Firmware for custom macropad PCB
+![Rama Works X Machine Industries M10-A Macropad](https://raw.githubusercontent.com/noroadsleft/qmk_images/master/keyboards/m10a/image-asset9_640.jpg)
 
-Keyboard Maintainer: QMK Community   
-Hardware Supported: Rama Works M10-A  
-Hardware Availability: [Rama Works](https://rama.works/m10-a)
+A 10-key macro pad with support for single-color LED backlighting in a milled aluminum case.
+
+* Keyboard Maintainer: QMK Community
+* Hardware Supported: Rama Works M10-A
+* Hardware Availability: [Rama Works](https://rama.works/m10-a)
 
 Make example for this keyboard (after setting up your build environment):
 
     make m10a:default
 
-See [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) then the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information.
+Flashing example for this keyboard:
+
+    make m10a:default:flash
+
+To reset the board into bootloader mode, tap the Reset switch mounted on the top side of the PCB, beneath the 2u keycap.
+
+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).