Update --reason flag usage example with detailed migration message

Author: simonjjones

command/v7/update_stack_command.go

@@ -16,7 +16,7 @@ type UpdateStackCommand struct {
 	RequiredArgs    flag.StackName `positional-args:"yes"`
 	State           string         `long:"state" description:"State to transition the stack to (active, restricted, deprecated, disabled)" required:"true"`
 	Reason          string         `long:"reason" description:"Optional plain text describing the stack state change"`
-	usage           interface{}    `usage:"CF_NAME update-stack STACK_NAME [--state (active | restricted | deprecated | disabled)] [--reason REASON]\n\nEXAMPLES:\n   CF_NAME update-stack cflinuxfs3 --state disabled\n   CF_NAME update-stack cflinuxfs3 --state deprecated --reason 'Use cflinuxfs4 instead'"`
+	usage           interface{}    `usage:"CF_NAME update-stack STACK_NAME [--state (active | restricted | deprecated | disabled)] [--reason text]\n\nEXAMPLES:\n   CF_NAME update-stack cflinuxfs3 --state disabled\n   CF_NAME update-stack cflinuxfs3 --state deprecated --reason \"This stack is based on Ubuntu 18.04, which is no longer supported. Please migrate your applications to 'cflinuxfs4'. For more information, see: <link-to-docs>.\""`
 	relatedCommands interface{}    `related_commands:"stack, stacks"`
 }
 

integration/v7/isolated/update_stack_command_test.go

@@ -44,10 +44,10 @@ var _ = Describe("update-stack command", func() {
 				Eventually(session).Should(Say(`NAME:`))
 				Eventually(session).Should(Say(`update-stack - Transition a stack between the defined states`))
 				Eventually(session).Should(Say(`USAGE:`))
-				Eventually(session).Should(Say(`cf update-stack STACK_NAME \[--state \(active \| restricted \| deprecated \| disabled\)\] \[--reason REASON\]`))
+				Eventually(session).Should(Say(`cf update-stack STACK_NAME \[--state \(active \| restricted \| deprecated \| disabled\)\] \[--reason text\]`))
 				Eventually(session).Should(Say(`EXAMPLES:`))
 				Eventually(session).Should(Say(`cf update-stack cflinuxfs3 --state disabled`))
-				Eventually(session).Should(Say(`cf update-stack cflinuxfs3 --state deprecated --reason 'Use cflinuxfs4 instead'`))
+				Eventually(session).Should(Say(`cf update-stack cflinuxfs3 --state deprecated --reason "This stack is based on Ubuntu 18.04, which is no longer supported. Please migrate your applications to 'cflinuxfs4'. For more information, see: <link-to-docs>."`))
 				Eventually(session).Should(Say(`OPTIONS:`))
 				Eventually(session).Should(Say(`--state\s+State to transition the stack to`))
 				Eventually(session).Should(Say(`SEE ALSO:`))