diff --git a/keyboards/mariorion_v25/readme.md b/keyboards/mariorion_v25/readme.md
index 798338d90dd4..3d036aebc85e 100644
--- a/keyboards/mariorion_v25/readme.md
+++ b/keyboards/mariorion_v25/readme.md
@@ -3,11 +3,13 @@
 ![mariorion_v25_1](https://i.imgur.com/3OrUK2ph.jpeg)
 ![mariorion_v25_2](https://i.imgur.com/OvMBHOlh.jpeg)
 
-*A short description of the keyboard/project*
+This project was a revival of the Duck Orion v2.5, where we don't have very many PCBs with modern features, and 
+especially Alps support as well. This PCB has both Alps and MX support as well as universal layout support! It also 
+features a 3u/1u/3u split spacebar variant for fun :)
 
 * Keyboard Maintainer: [Maria](https://github.com/toril940)
 * Hardware Supported: MariOrion v2.5 PCB
-* Hardware Availability: *Links to where you can find this hardware*
+* Hardware Availability: Link coming soon, through Hineybush :)
 
 Make example for this keyboard (after setting up your build environment):
 
@@ -27,5 +29,5 @@ See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_to
 Enter the bootloader in 3 ways:
 
 * **Bootmagic reset**: Hold down the key at (0,0) in the matrix (usually the top left key or Escape) and plug in the keyboard
-* **Physical reset button**: Briefly press the button on the back of the PCB - some may have pads you must short instead
+* **Physical reset button**: Hold the reset button on the back of the PCB for 4-10 seconds or so - 
 * **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available