diff --git a/plugins/processors/regex/README.md b/plugins/processors/regex/README.md
index c9eec037b..d37b1ea88 100644
--- a/plugins/processors/regex/README.md
+++ b/plugins/processors/regex/README.md
@@ -14,10 +14,12 @@ The `regex` plugin transforms tag and field values with regex pattern. If `resul
     key = "resp_code"
     ## Regular expression to match on a tag value
     pattern = "^(\\d)\\d\\d$"
-    ## Pattern for constructing a new value (${1} represents first subgroup)
+    ## Matches of the pattern will be replaced with this string.  Use ${1}
+    ## notation to use the text of the first submatch.
     replacement = "${1}xx"
 
   [[processors.regex.fields]]
+    ## Field to change
     key = "request"
     ## All the power of the Go regular expressions available here
     ## For example, named subgroups
diff --git a/plugins/processors/regex/regex.go b/plugins/processors/regex/regex.go
index f73ed06b6..b922cd2d5 100644
--- a/plugins/processors/regex/regex.go
+++ b/plugins/processors/regex/regex.go
@@ -27,14 +27,16 @@ const sampleConfig = `
   #   key = "resp_code"
   #   ## Regular expression to match on a tag value
   #   pattern = "^(\\d)\\d\\d$"
-  #   ## Pattern for constructing a new value (${1} represents first subgroup)
+  #   ## Matches of the pattern will be replaced with this string.  Use ${1}
+  #   ## notation to use the text of the first submatch.
   #   replacement = "${1}xx"
 
   # [[processors.regex.fields]]
+  #   ## Field to change
   #   key = "request"
   #   ## All the power of the Go regular expressions available here
   #   ## For example, named subgroups
-  #   pattern = "^/api(?P<method>/[\\w/]+)\\S*" 
+  #   pattern = "^/api(?P<method>/[\\w/]+)\\S*"
   #   replacement = "${method}"
   #   ## If result_key is present, a new field will be created
   #   ## instead of changing existing field