diff --git a/src/main/resources/Documentation/cmd-list.md b/src/main/resources/Documentation/cmd-list.md
index c5116a7..fcb7be8 100644
--- a/src/main/resources/Documentation/cmd-list.md
+++ b/src/main/resources/Documentation/cmd-list.md
@@ -1,7 +1,26 @@
+@PLUGIN@ list
+=================
+
+NAME
+----
+@PLUGIN@ list display rate limit statistics
+
+SYNOPSIS
+--------
+>     ssh -p <port> <host> @PLUGIN@ list
+
+DESCRIPTION
+-----------
+Displays rate limit statistics: account id (or IP if request is anonymous),
+permits per hour, remaining permits and when they will be replenished.
+
+The time before permits are replenished is represented using ISO-8601 seconds
 based representation, such as PT59M30S (59 minutes and 30 seconds).
+
 ACCESS
 ------
 Gerrit Administrators only.
+
 EXAMPLES
 --------
 >     $ ssh -p @SSH_PORT@ @SSH_HOST@ @PLUGIN@ list