diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cf67f95
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# Fedora Fingerprint Feedback
+
+Deployable scripts to improve visible feedback speed for failed fingerprint scans
+in GNOME/GDM on Fedora systems managed by `authselect`.
+
+## Repository layout
+- `tools/gnome_fprint_feedback_setup.sh`
+- `tools/gnome_fprint_feedback_rollback.sh`
+- `docs/gnome-fingerprint-feedback-deploy.md`
+
+## Quick start
+```bash
+sudo ./tools/gnome_fprint_feedback_setup.sh --max-tries 2 --timeout 6
+```
+
+## Rollback
+```bash
+sudo ./tools/gnome_fprint_feedback_rollback.sh
+```
diff --git a/Main/gnome-fingerprint-feedback-deploy.md b/docs/gnome-fingerprint-feedback-deploy.md
similarity index 83%
rename from Main/gnome-fingerprint-feedback-deploy.md
rename to docs/gnome-fingerprint-feedback-deploy.md
index 16191aa..e198cfc 100644
--- a/Main/gnome-fingerprint-feedback-deploy.md
+++ b/docs/gnome-fingerprint-feedback-deploy.md
@@ -1,6 +1,7 @@
 # GNOME/GDM Fingerprint Feedback Deployment
 
-This provides a team-friendly deployment path for faster visible fingerprint failure feedback on Fedora systems using authselect.
+This repository provides a team-friendly deployment path for faster visible
+fingerprint failure feedback on Fedora systems using authselect.
 
 ## Files
 - `tools/gnome_fprint_feedback_setup.sh`
@@ -11,7 +12,7 @@ This provides a team-friendly deployment path for faster visible fingerprint fai
 Default (recommended):
 
 ```bash
-cd /home/jan/Documents/RFP/WLED-MM/repo
+cd /path/to/Fedora_Fingerprint_Feedback
 sudo ./tools/gnome_fprint_feedback_setup.sh
 ```
 
@@ -41,7 +42,7 @@ pam_fprintd.so max-tries=2 timeout=6
 Restore previous authselect selection saved during setup:
 
 ```bash
-cd /home/jan/Documents/RFP/WLED-MM/repo
+cd /path/to/Fedora_Fingerprint_Feedback
 sudo ./tools/gnome_fprint_feedback_rollback.sh
 ```
 
diff --git a/Main/gnome_fprint_feedback_rollback.sh b/tools/gnome_fprint_feedback_rollback.sh
similarity index 100%
rename from Main/gnome_fprint_feedback_rollback.sh
rename to tools/gnome_fprint_feedback_rollback.sh
diff --git a/Main/gnome_fprint_feedback_setup.sh b/tools/gnome_fprint_feedback_setup.sh
similarity index 100%
rename from Main/gnome_fprint_feedback_setup.sh
rename to tools/gnome_fprint_feedback_setup.sh