1 files changed, 18 insertions, 0 deletions

diff --git a/keyboards/ferris/sweep/readme.md b/keyboards/ferris/sweep/readme.md
new file mode 100644
index 000000000..d7102aa1a
--- /dev/null
+++ b/keyboards/ferris/sweep/readme.md
@@ -0,0 +1,18 @@
+# Ferris sweep
+
+![Ferris sweep, top view](https://i.imgur.com/5qCZUv6h.jpg)
+![Ferris sweep, bottom view](https://i.imgur.com/ZC47CJth.jpg)
+
+A version of the Ferris keyboard that uses a daughterboard, designed by the fantastic @davidphilipbarr with some input from @pierrechevalier83 for the copper pad. All PCB files are available on the [project's github page](https://github.com/davidphilipbarr/Sweep)
+
+* Keyboard Maintainer: [Pierre Chevalier](https://github.com/pierrechevalier83)
+* Hardware Supported:
+        * Ferris sweep (With pro-micro. Comes in a couple of PCB edge cuts shapes, but with identical pinout)
+* Hardware Availability: @iamnotyourbroom in the 40% discord chat server may have some spares for you.
+
+Make examples for this keyboard (after setting up your build environment):
+
+    make ferris/sweep:default:avrdude-split-left
+    make ferris/sweep:default:avrdude-split-right
+
+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).