diff --git a/man/man1/string.1 b/man/man1/string.1
index c7fb784..d15e451 100644
--- a/man/man1/string.1
+++ b/man/man1/string.1
@@ -39,7 +39,13 @@ position, counting and replacing substrings
 .IP \[bu] 2
 splitting a string into a JSON array of strings, joining JSON a string
 arrays into a string
+.PP
+VERB refers to the operation to performed on the supplied string(s).
+VER PARAMETERS are thsose additional terms need to complete the process
+provided by the VERB.
 .SH OPTIONS
+.PP
+Options always come before the VERB.
 .TP
 -help
 display help
diff --git a/string.1.md b/string.1.md
index 90a711f..2308b65 100644
--- a/string.1.md
+++ b/string.1.md
@@ -23,8 +23,14 @@ string is a command line tool for transforming strings in common ways.
 - position, counting and replacing substrings
 - splitting a string into a JSON array of strings, joining JSON a string arrays into a string
 
+VERB refers to the operation to performed on the supplied string(s).
+VER PARAMETERS are thsose additional terms need to complete the process
+provided by the VERB.
+
 # OPTIONS
 
+Options always come before the VERB.
+
 -help
 : display help