diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a0c6894
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# no-stone-wall-alarm Factorio Mod
+
+## Purpose
+Disables the alarm sound and notifications for destroyed stone walls and construction robots.
+
+## Installation
+Install via https://mods.factorio.com/mod/no-stone-wall-alarm or directly in-game.
+
+## License
+GPLv3 only.
+
+## Quirks
+The ghosts for Stone Walls will look wrong (not like the wall was destroyed, but like you manually placed ghosts).
+
+Note: This mod suppresses the `on_entity_died` events for stone walls and construction robots. If you have other mods that rely on these events for those items, then you shouldn't use this mod.