Updating help text of some commands to better fit with auto documentation

Author: allmightyspiff

plugin/commands/subnet/create.go

@@ -1,15 +1,17 @@
 package subnet
 
 import (
-	"strconv"
-
+	"fmt"
 	"github.com/spf13/cobra"
 	"github.ibm.com/SoftLayer/softlayer-cli/plugin/errors"
 	slErr "github.ibm.com/SoftLayer/softlayer-cli/plugin/errors"
 	. "github.ibm.com/SoftLayer/softlayer-cli/plugin/i18n"
 	"github.ibm.com/SoftLayer/softlayer-cli/plugin/managers"
 	"github.ibm.com/SoftLayer/softlayer-cli/plugin/metadata"
 	"github.ibm.com/SoftLayer/softlayer-cli/plugin/utils"
+	"strconv"
+	"strings"
+
 )
 
 type CreateCommand struct {
@@ -22,27 +24,22 @@ type CreateCommand struct {
 }
 
 func NewCreateCommand(sl *metadata.SoftlayerCommand) *CreateCommand {
-	thisCmd := &CreateCommand{
+    thisCmd := &CreateCommand{
 		SoftlayerCommand: sl,
 		NetworkManager:   managers.NewNetworkManager(sl.Session),
 	}
 	cobraCmd := &cobra.Command{
-		Use:   "create",
+		Use:   "create" + strings.ToUpper(fmt.Sprintf(" %s %s %s", T("Network"), T("Quantity"), T("VLAN"))),
 		Short: T("Add a new subnet to your account"),
-		Long: T(`${COMMAND_NAME} sl subnet create NETWORK QUANTITY VLAN_ID [OPTIONS]
-	
-	Add a new subnet to your account. Valid quantities vary by type.
-	
-	Type    - Valid Quantities (IPv4)
-  	public  - 4, 8, 16, 32
-  	private - 4, 8, 16, 32, 64
+		Long: T(`Valid quantities vary by type.
 
-  	Type    - Valid Quantities (IPv6)
-	public  - 64
+	- public IPv4: 4, 8, 16, 32
+	- private IPv4: 4, 8, 16, 32, 64 
+	- public IPv6: 64
 
 EXAMPLE:
-   ${COMMAND_NAME} sl subnet create public 16 567 
-   This command creates a public subnet with 16 IPv4 addresses and places it on vlan with ID 567.`),
+	${COMMAND_NAME} sl subnet create public 16 567 
+	This command creates a public subnet with 16 IPv4 addresses and places it on vlan with ID 567.`),
 		Args: metadata.ThreeArgs,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return thisCmd.Run(args)

plugin/commands/user/edit_notifications.go

@@ -29,11 +29,10 @@ func NewEditNotificationsCommand(sl *metadata.SoftlayerCommand) (cmd *EditNotifi
 	cobraCmd := &cobra.Command{
 		Use:   "edit-notifications",
 		Short: T("Enable or Disable specific notifications for the active user."),
-		Long: T(`${COMMAND_NAME} sl user edit-notifications [OPTIONS] NOTIFICATIONS
-
-		Notification names should be enclosed in quotation marks. Examples:
-			slcli user edit-notifications --enable 'Order Approved'
-			slcli user edit-notifications --enable 'Order Approved' --enable  'Reload Complete'`),
+		Long: T(`Notification names should be enclosed in quotation marks.
+EXAMPLE:
+	slcli user edit-notifications --enable 'Order Approved'
+	slcli user edit-notifications --enable 'Order Approved' --enable 'Reload Complete'`),
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return thisCmd.Run(args)
 		},

plugin/commands/virtual/upgrade.go

@@ -35,14 +35,12 @@ func NewUpgradeCommand(sl *metadata.SoftlayerCommand) (cmd *UpgradeCommand) {
 	cobraCmd := &cobra.Command{
 		Use:   "upgrade " + T("IDENTIFIER"),
 		Short: T("Upgrade a virtual server instance"),
-		Long: T(`${COMMAND_NAME} sl vs upgrade IDENTIFIER [OPTIONS]
-	Note: Classic infrastructure service automatically reboots the instance once upgrade request is
-  	placed. The instance is halted until the upgrade transaction is completed.
-  	However for Network, no reboot is required.
+		Long: T(`Note: This virtual server will be rebooted once the upgrade order is placed.
+The instance is halted until the upgrade transaction is completed. However for Network, no reboot is required.
 
 EXAMPLE:
-   ${COMMAND_NAME} sl vs upgrade 12345678 -c 8 -m 8192 --network 1000
-   This commands upgrades virtual server instance with ID 12345678 and set number of CPU cores to 8, memory to 8192M, network port speed to 1000 Mbps.`),
+	${COMMAND_NAME} sl vs upgrade 12345678 -c 8 -m 8192 --network 1000
+	This commands upgrades virtual server instance with ID 12345678 and set number of CPU cores to 8, memory to 8192M, network port speed to 1000 Mbps.`),
 		Args: metadata.OneArgs,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return thisCmd.Run(args)