diff --git a/docs/plugins/resume.rst b/docs/plugins/resume.rst
index ccca39e28..d8feb0896 100644
--- a/docs/plugins/resume.rst
+++ b/docs/plugins/resume.rst
@@ -1,4 +1,15 @@
 resume
 ======
-Allows automatic resumption of suspended constructions, along with colored
-UI hints for construction status.
+Tags:
+:dfhack-keybind:``
+
+Color planned buildings based on their suspend status. When enabled, this plugin
+will display a colored 'X' over suspended buildings. When run as a command, it
+can resume all suspended building jobs, allowing you to quickly recover if a
+bunch of jobs were suspended due to the workers getting scared off by wildlife
+or items temporarily blocking buildling sites.
+
+Usage::
+
+    enable resume
+    resume all
diff --git a/plugins/resume.cpp b/plugins/resume.cpp
index 6b8ad5e7d..21a4b521e 100644
--- a/plugins/resume.cpp
+++ b/plugins/resume.cpp
@@ -302,18 +302,9 @@ DFhackCExport command_result plugin_init ( color_ostream &out, std::vector <Plug
 {
     commands.push_back(
         PluginCommand(
-        "resume", "Display and easily resume suspended constructions",
-        resume_cmd, false,
-        "resume show\n"
-        "  Show overlay when paused:\n"
-        "    Yellow: Suspended construction\n"
-        "    Red: Suspended after resume attempt, possibly stuck\n"
-        "    Green: Planned building waiting for materials\n"
-        "resume hide\n"
-        "  Hide overlay\n"
-        "resume all\n"
-        "  Resume all suspended building constructions\n"
-        ));
+        "resume",
+        "Mark suspended constructions on the map and easily resume them.",
+        resume_cmd));
 
     return CR_OK;
 }