diff --git a/modules/reference/pages/rpk/rpk-security/rpk-security-user-update.adoc b/modules/reference/pages/rpk/rpk-security/rpk-security-user-update.adoc
index 97bb5432bd..d1510b8d50 100644
--- a/modules/reference/pages/rpk/rpk-security/rpk-security-user-update.adoc
+++ b/modules/reference/pages/rpk/rpk-security/rpk-security-user-update.adoc
@@ -15,7 +15,7 @@ CAUTION: The default value for the `--mechanism` flag is `SCRAM-SHA-256`. Set th
 
 [,bash]
 ----
-rpk security user update [USER] --new-password [PW] [flags]
+rpk security user update [USER] --new-password [PW] --mechanism [MECHANISM] [flags]
 ----
 
 == Flags
@@ -26,8 +26,7 @@ rpk security user update [USER] --new-password [PW] [flags]
 
 |-h, --help |- |Help for update.
 
-|--mechanism |string |SASL mechanism to use for the user you are
-updating. Case insensitive. Acceptable values: `scram-sha-256`, `scram-sha-512`. (default `scram-sha-256`).
+|--mechanism |string |SASL mechanism to use for the user you are updating. Case insensitive. Acceptable values: `SCRAM-SHA-256`, `SCRAM-SHA-512`. 
 
 |--new-password |string |New user's password.
 
diff --git a/modules/reference/pages/rpk/rpk-topic/rpk-topic-describe.adoc b/modules/reference/pages/rpk/rpk-topic/rpk-topic-describe.adoc
index 97ccff773a..80bdee5e75 100644
--- a/modules/reference/pages/rpk/rpk-topic/rpk-topic-describe.adoc
+++ b/modules/reference/pages/rpk/rpk-topic/rpk-topic-describe.adoc
@@ -4,6 +4,8 @@
 This command prints detailed information about topics. There are three potential views: a summary of the topic, the topic configurations, and a detailed
 partitions section. By default, the summary and configs sections are printed.
 
+Using the `--format` flag with either JSON or YAML prints all the topic information.
+
 The `--regex` flag (`-r`) parses arguments as regular expressions and describes topics that match any of the expressions.
 
 == Usage
@@ -32,6 +34,8 @@ describe, info
 
 |-c, --print-configs |- |Print the config section.
 
+|--format |string |Output format. Possible values: `json`, `yaml`, `text`, `wide`, `help`. Default: `text`.
+
 |-p, --print-partitions |- |Print the detailed partitions section.
 
 |-s, --print-summary |- |Print the summary section.