diff --git a/Debug-flags.md b/Debug-flags.md
new file mode 100644
index 0000000..7942fff
--- /dev/null
+++ b/Debug-flags.md
@@ -0,0 +1,10 @@
+Sway has some debugging options available via the `-D` command-line flag.
+
+- `-D damage=highlight`: paints regions that haven't been updated in yellow
+- `-D damage=rerender`: disables damage tracking by forcing the whole output to be repainted each frame
+- `-D noatomic`: disables atomic transactions
+- `-D txn_wait`: forces all atomic transactions to time out
+- `-D txn-timings`: logs addition information about transaction timings
+- `-D txn-timeout=<ms>`: overrides the default atomic transaction timeout
+
+Also see `enable_debug_flag()`.
\ No newline at end of file