docs(usage): Consistent formatting of short descriptions

cli/cmd/exec.go

@@ -44,8 +44,8 @@
 			Use:   "exec",
 			Args:  cobra.MinimumNArgs(1),
 			Short: "Run a command in Codesphere workspace",
-			Long: `Run a command in a Codesphere workspace.
-  Output will be printed to STDOUT, errors to STDERR.`,
+			Long: out.Long(`Run a command in a Codesphere workspace.
+  			Output will be printed to STDOUT, errors to STDERR.`),
 			Example: out.FormatExampleCommands("exec", []out.Example{
 				{Cmd: "-- echo hello world", Desc: "Print `hello world`"},
 				{Cmd: "-- find .", Desc: "List all files in workspace"},

cli/cmd/list-teams.go

@@ -22,8 +22,8 @@ func addListTeamsCmd(p *cobra.Command, opts GlobalOptions) {
 	l := ListTeamsCmd{
 		cmd: &cobra.Command{
 			Use:   "teams",
-			Short: "list teams",
-			Long:  `list teams available in Codesphere`,
+			Short: "List teams",
+			Long:  `List teams available in Codesphere`,
 			Example: out.FormatExampleCommands("list teams", []out.Example{
 				{Desc: "List all teams"},
 			}),

cli/cmd/list-workspaces.go

@@ -22,8 +22,8 @@ func addListWorkspacesCmd(p *cobra.Command, opts GlobalOptions) {
 	l := ListWorkspacesCmd{
 		cmd: &cobra.Command{
 			Use:   "workspaces",
-			Short: "list workspaces",
-			Long:  `list workspaces available in Codesphere`,
+			Short: "List workspaces",
+			Long:  `List workspaces available in Codesphere`,
 			Example: out.FormatExampleCommands("list workspaces", []out.Example{
 				{Cmd: "--team-id <team-id>", Desc: "List all workspaces"},
 			}),

cli/cmd/list.go

@@ -16,8 +16,8 @@ func AddListCmd(rootCmd *cobra.Command, opts GlobalOptions) {
 	l := ListCmd{
 		cmd: &cobra.Command{
 			Use:   "list",
-			Short: "list resources",
-			Long:  `list resources available in Codesphere`,
+			Short: "List resources",
+			Long:  `List resources available in Codesphere`,
 			Example: out.FormatExampleCommands("list", []out.Example{
 				{Cmd: "workspaces", Desc: "List all workspaces"},
 			}),

cli/cmd/log.go

@@ -57,7 +57,7 @@ func AddLogCmd(rootCmd *cobra.Command, opts GlobalOptions) {
 	logCmd := LogCmd{
 		cmd: &cobra.Command{
 			Use:   "log",
-			Short: "Retrieve Run logs from services",
+			Short: "Retrieve run logs from services",
 			Long: `You can retrieve logs based on the given scope.
 
 If you provide the step number and server, it returns all logs from

cli/cmd/open-workspace.go

@@ -39,8 +39,8 @@ func AddOpenWorkspaceCmd(open *cobra.Command, opts GlobalOptions) {
 	workspace := OpenWorkspaceCmd{
 		cmd: &cobra.Command{
 			Use:   "workspace",
-			Short: "Open workspace in web browser",
-			Long:  `Open workspace in the Codesphere IDE.`,
+			Short: "Open workspace in the Codesphere IDE",
+			Long:  `Open workspace in the Codesphere IDE in your web browser.`,
 			Example: out.FormatExampleCommands("open workspace", []out.Example{
 				{Cmd: "-w 42", Desc: "open workspace 42 in web browser"},
 				{Cmd: "", Desc: "open workspace set by environment variable CS_WORKSPACE_ID"},

cli/cmd/open.go

@@ -27,8 +27,8 @@ func AddOpenCmd(rootCmd *cobra.Command, opts GlobalOptions) {
 	open := OpenCmd{
 		cmd: &cobra.Command{
 			Use:   "open",
-			Short: "Open the codesphere IDE",
-			Long:  `Open the codesphere IDE.`,
+			Short: "Open the Codesphere IDE",
+			Long:  `Open the Codesphere IDE.`,
 		},
 	}
 	rootCmd.AddCommand(open.cmd)

cli/cmd/root.go

@@ -63,7 +63,7 @@ func (o GlobalOptions) GetWorkspaceId() (int, error) {
 func GetRootCmd() *cobra.Command {
 	var rootCmd = &cobra.Command{
 		Use:   "cs",
-		Short: "The codesphere CLI",
+		Short: "The Codesphere CLI",
 		Long:  `Manage and debug resources deployed in Codesphere via command line.`,
 	}
 

cli/cmd/set-env-vars.go

@@ -25,8 +25,8 @@ func AddSetEnvVarCmd(p *cobra.Command, opts GlobalOptions) {
 	l := SetEnvVarCmd{
 		cmd: &cobra.Command{
 			Use:   "set-env",
-			Short: "set env vars",
-			Long:  `set environment variables for your workspace`,
+			Short: "Set environment varariables",
+			Long:  `Set environment variables in a workspace`,
 			Example: out.FormatExampleCommands("set-env", []out.Example{
 				{Cmd: "--workspace <workspace-id> --env-var foo=bar", Desc: "Set single environment variable"},
 				{Cmd: "--workspace <workspace-id> --env-var foo=bar --env-var hello=world", Desc: "Set multiple environment variables"},