diff --git a/Documentation/btrfs-check.asciidoc b/Documentation/btrfs-check.asciidoc
index b963eae5..28b21e01 100644
--- a/Documentation/btrfs-check.asciidoc
+++ b/Documentation/btrfs-check.asciidoc
@@ -98,6 +98,11 @@ DANGEROUS OPTIONS
 
 --repair::
 enable the repair mode and attempt to fix problems where possible
++
+NOTE: there's a warning and 10 second delay when this option is run without
+'--force' to give users a chance to think twice before running repair, the
+warnings in documentation have shown to be insufficient
+
 --init-csum-tree::
 create a new checksum tree and recalculate checksums in all files
 +
@@ -126,6 +131,8 @@ allow work on a mounted filesystem. Note that this should work fine on a
 quiescent or read-only mounted filesystem but may crash if the device is
 changed externally, eg. by the kernel module.  Repair without mount checks is
 not supported right now.
++
+This option skips the delay and warning in the repair mode (see '--repair')
 
 EXIT STATUS
 -----------