commands: description cleanup

42 files changed, 85 insertions, 85 deletions

diff --git a/commands/comment.go b/commands/comment.go
index 9169d7d7..c05fd255 100644
--- a/commands/comment.go
+++ b/commands/comment.go
@@ -44,7 +44,7 @@ func commentsTextOutput(comments []bug.Comment) {
 
 var commentCmd = &cobra.Command{
 	Use:   "comment [<id>]",
-	Short: "Show a bug's comments",
+	Short: "Display or add comments",
 	RunE:  runComment,
 }
 
diff --git a/commands/comment_add.go b/commands/comment_add.go
index c80e9ec5..8898ea45 100644
--- a/commands/comment_add.go
+++ b/commands/comment_add.go
@@ -54,7 +54,7 @@ func runCommentAdd(cmd *cobra.Command, args []string) error {
 
 var commentAddCmd = &cobra.Command{
 	Use:   "add [<id>]",
-	Short: "Add a new comment to a bug",
+	Short: "Add a new comment",
 	RunE:  runCommentAdd,
 }
 
diff --git a/commands/label add.go b/commands/label add.go
index 68811dec..06c4e6c5 100644
--- a/commands/label add.go
+++ b/commands/label add.go
@@ -35,7 +35,7 @@ func runLabelAdd(cmd *cobra.Command, args []string) error {
 
 var labelAddCmd = &cobra.Command{
 	Use:   "add [<id>] <label>[...]",
-	Short: "Add a label to a bug",
+	Short: "Add a label",
 	RunE:  runLabelAdd,
 }
 
diff --git a/commands/label rm.go b/commands/label rm.go
index 8ad89593..5e9c8f24 100644
--- a/commands/label rm.go
+++ b/commands/label rm.go
@@ -35,7 +35,7 @@ func runLabelRm(cmd *cobra.Command, args []string) error {
 
 var labelRmCmd = &cobra.Command{
 	Use:   "rm [<id>] <label>[...]",
-	Short: "Remove a label from a bug",
+	Short: "Remove a label",
 	RunE:  runLabelRm,
 }
 
diff --git a/commands/label.go b/commands/label.go
index d41b6dfb..fd958d68 100644
--- a/commands/label.go
+++ b/commands/label.go
@@ -31,7 +31,7 @@ func runLabel(cmd *cobra.Command, args []string) error {
 
 var labelCmd = &cobra.Command{
 	Use:   "label [<id>]",
-	Short: "Display a bug labels",
+	Short: "Display, add or remove labels",
 	RunE:  runLabel,
 }
 
diff --git a/commands/root.go b/commands/root.go
index 95a43516..298fb427 100644
--- a/commands/root.go
+++ b/commands/root.go
@@ -20,8 +20,8 @@ var RootCmd = &cobra.Command{
 	Version: "0.3.0",
 
 	Use:   rootCommandName,
-	Short: "A bugtracker embedded in Git",
-	Long: `git-bug is a bugtracker embedded in git.
+	Short: "A bug tracker embedded in Git",
+	Long: `git-bug is a bug tracker embedded in git.
 
 It use the same internal storage so it doesn't pollute your project. As you would do with commits and branches, you can push your bugs to the same git remote your are already using to collaborate with other peoples.`,
 
diff --git a/commands/status.go b/commands/status.go
index 02ddc481..a34b0918 100644
--- a/commands/status.go
+++ b/commands/status.go
@@ -29,7 +29,7 @@ func runStatus(cmd *cobra.Command, args []string) error {
 
 var statusCmd = &cobra.Command{
 	Use:   "status [<id>]",
-	Short: "Show the bug status",
+	Short: "Display or change a bug status",
 	RunE:  runStatus,
 }
 
diff --git a/commands/status_close.go b/commands/status_close.go
index de8b990c..fd713a39 100644
--- a/commands/status_close.go
+++ b/commands/status_close.go
@@ -28,7 +28,7 @@ func runStatusClose(cmd *cobra.Command, args []string) error {
 
 var closeCmd = &cobra.Command{
 	Use:   "close [<id>]",
-	Short: "Mark the bug as closed",
+	Short: "Mark a bug as closed",
 	RunE:  runStatusClose,
 }
 
diff --git a/commands/status_open.go b/commands/status_open.go
index 6b94b9cb..9c6363a0 100644
--- a/commands/status_open.go
+++ b/commands/status_open.go
@@ -28,7 +28,7 @@ func runStatusOpen(cmd *cobra.Command, args []string) error {
 
 var openCmd = &cobra.Command{
 	Use:   "open [<id>]",
-	Short: "Mark the bug as open",
+	Short: "Mark a bug as open",
 	RunE:  runStatusOpen,
 }
 
diff --git a/commands/title.go b/commands/title.go
index dd5fbfb1..f930ffb1 100644
--- a/commands/title.go
+++ b/commands/title.go
@@ -29,7 +29,7 @@ func runTitle(cmd *cobra.Command, args []string) error {
 
 var titleCmd = &cobra.Command{
 	Use:   "title [<id>]",
-	Short: "Display a bug's title",
+	Short: "Display or change a title",
 	RunE:  runTitle,
 }
 
diff --git a/commands/title_edit.go b/commands/title_edit.go
index a62daf6c..9d37dc5c 100644
--- a/commands/title_edit.go
+++ b/commands/title_edit.go
@@ -48,7 +48,7 @@ func runTitleEdit(cmd *cobra.Command, args []string) error {
 
 var titleEditCmd = &cobra.Command{
 	Use:   "edit [<id>]",
-	Short: "Edit a bug title",
+	Short: "Edit a title",
 	RunE:  runTitleEdit,
 }
 
diff --git a/doc/man/git-bug-comment-add.1 b/doc/man/git-bug-comment-add.1
index 304109cf..0df55e7f 100644
--- a/doc/man/git-bug-comment-add.1
+++ b/doc/man/git-bug-comment-add.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-comment\-add \- Add a new comment to a bug
+git\-bug\-comment\-add \- Add a new comment
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-comment\-add \- Add a new comment to a bug
 
 .SH DESCRIPTION
 .PP
-Add a new comment to a bug
+Add a new comment
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-comment.1 b/doc/man/git-bug-comment.1
index bbac0f33..6cd5d6a6 100644
--- a/doc/man/git-bug-comment.1
+++ b/doc/man/git-bug-comment.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-comment \- Show a bug's comments
+git\-bug\-comment \- Display or add comments
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-comment \- Show a bug's comments
 
 .SH DESCRIPTION
 .PP
-Show a bug's comments
+Display or add comments
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-label-add.1 b/doc/man/git-bug-label-add.1
index f34a6943..f05e0194 100644
--- a/doc/man/git-bug-label-add.1
+++ b/doc/man/git-bug-label-add.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-label\-add \- Add a label to a bug
+git\-bug\-label\-add \- Add a label
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-label\-add \- Add a label to a bug
 
 .SH DESCRIPTION
 .PP
-Add a label to a bug
+Add a label
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-label-rm.1 b/doc/man/git-bug-label-rm.1
index 72578bf8..829721e6 100644
--- a/doc/man/git-bug-label-rm.1
+++ b/doc/man/git-bug-label-rm.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-label\-rm \- Remove a label from a bug
+git\-bug\-label\-rm \- Remove a label
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-label\-rm \- Remove a label from a bug
 
 .SH DESCRIPTION
 .PP
-Remove a label from a bug
+Remove a label
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-label.1 b/doc/man/git-bug-label.1
index eecdc43b..d2be213a 100644
--- a/doc/man/git-bug-label.1
+++ b/doc/man/git-bug-label.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-label \- Display a bug labels
+git\-bug\-label \- Display, add or remove labels
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-label \- Display a bug labels
 
 .SH DESCRIPTION
 .PP
-Display a bug labels
+Display, add or remove labels
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-status-close.1 b/doc/man/git-bug-status-close.1
index 27ab6442..59c24474 100644
--- a/doc/man/git-bug-status-close.1
+++ b/doc/man/git-bug-status-close.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-status\-close \- Mark the bug as closed
+git\-bug\-status\-close \- Mark a bug as closed
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-status\-close \- Mark the bug as closed
 
 .SH DESCRIPTION
 .PP
-Mark the bug as closed
+Mark a bug as closed
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-status-open.1 b/doc/man/git-bug-status-open.1
index d2f4a5cb..38a3cbc9 100644
--- a/doc/man/git-bug-status-open.1
+++ b/doc/man/git-bug-status-open.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-status\-open \- Mark the bug as open
+git\-bug\-status\-open \- Mark a bug as open
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-status\-open \- Mark the bug as open
 
 .SH DESCRIPTION
 .PP
-Mark the bug as open
+Mark a bug as open
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-status.1 b/doc/man/git-bug-status.1
index 7571e77b..ccf98703 100644
--- a/doc/man/git-bug-status.1
+++ b/doc/man/git-bug-status.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-status \- Show the bug status
+git\-bug\-status \- Display or change a bug status
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-status \- Show the bug status
 
 .SH DESCRIPTION
 .PP
-Show the bug status
+Display or change a bug status
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-title-edit.1 b/doc/man/git-bug-title-edit.1
index 4deae19a..fe79fff2 100644
--- a/doc/man/git-bug-title-edit.1
+++ b/doc/man/git-bug-title-edit.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-title\-edit \- Edit a bug title
+git\-bug\-title\-edit \- Edit a title
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-title\-edit \- Edit a bug title
 
 .SH DESCRIPTION
 .PP
-Edit a bug title
+Edit a title
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-title.1 b/doc/man/git-bug-title.1
index 3574dfb8..ae6f7871 100644
--- a/doc/man/git-bug-title.1
+++ b/doc/man/git-bug-title.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-title \- Display a bug's title
+git\-bug\-title \- Display or change a title
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-title \- Display a bug's title
 
 .SH DESCRIPTION
 .PP
-Display a bug's title
+Display or change a title
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug.1 b/doc/man/git-bug.1
index ae56f4a2..45435773 100644
--- a/doc/man/git-bug.1
+++ b/doc/man/git-bug.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug \- A bugtracker embedded in Git
+git\-bug \- A bug tracker embedded in Git
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug \- A bugtracker embedded in Git
 
 .SH DESCRIPTION
 .PP
-git\-bug is a bugtracker embedded in git.
+git\-bug is a bug tracker embedded in git.
 
 .PP
 It use the same internal storage so it doesn't pollute your project. As you would do with commits and branches, you can push your bugs to the same git remote your are already using to collaborate with other peoples.
diff --git a/doc/md/git-bug.md b/doc/md/git-bug.md
index f38c3c36..af5386ff 100644
--- a/doc/md/git-bug.md
+++ b/doc/md/git-bug.md
@@ -1,10 +1,10 @@
 ## git-bug
 
-A bugtracker embedded in Git
+A bug tracker embedded in Git
 
 ### Synopsis
 
-git-bug is a bugtracker embedded in git.
+git-bug is a bug tracker embedded in git.
 
 It use the same internal storage so it doesn't pollute your project. As you would do with commits and branches, you can push your bugs to the same git remote your are already using to collaborate with other peoples.
 
@@ -22,15 +22,15 @@ git-bug [flags]
 
 * [git-bug add](git-bug_add.md)	 - Create a new bug
 * [git-bug commands](git-bug_commands.md)	 - Display available commands
-* [git-bug comment](git-bug_comment.md)	 - Show a bug's comments
-* [git-bug label](git-bug_label.md)	 - Display a bug labels
+* [git-bug comment](git-bug_comment.md)	 - Display or add comments
+* [git-bug label](git-bug_label.md)	 - Display, add or remove labels
 * [git-bug ls](git-bug_ls.md)	 - List bugs
 * [git-bug pull](git-bug_pull.md)	 - Pull bugs update from a git remote
 * [git-bug push](git-bug_push.md)	 - Push bugs update to a git remote
 * [git-bug select](git-bug_select.md)	 - Select a bug for implicit use in future commands
 * [git-bug show](git-bug_show.md)	 - Display the details of a bug
-* [git-bug status](git-bug_status.md)	 - Show the bug status
+* [git-bug status](git-bug_status.md)	 - Display or change a bug status
 * [git-bug termui](git-bug_termui.md)	 - Launch the terminal UI
-* [git-bug title](git-bug_title.md)	 - Display a bug's title
+* [git-bug title](git-bug_title.md)	 - Display or change a title
 * [git-bug webui](git-bug_webui.md)	 - Launch the web UI
 
diff --git a/doc/md/git-bug_add.md b/doc/md/git-bug_add.md
index 21060f61..d212c9b1 100644
--- a/doc/md/git-bug_add.md
+++ b/doc/md/git-bug_add.md
@@ -21,5 +21,5 @@ git-bug add [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_commands.md b/doc/md/git-bug_commands.md
index a653d523..6d777b40 100644
--- a/doc/md/git-bug_commands.md
+++ b/doc/md/git-bug_commands.md
@@ -19,5 +19,5 @@ git-bug commands [<option>...] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_comment.md b/doc/md/git-bug_comment.md
index 3e12fbfd..7ac0c835 100644
--- a/doc/md/git-bug_comment.md
+++ b/doc/md/git-bug_comment.md
@@ -1,10 +1,10 @@
 ## git-bug comment
 
-Show a bug's comments
+Display or add comments
 
 ### Synopsis
 
-Show a bug's comments
+Display or add comments
 
 ```
 git-bug comment [<id>] [flags]
@@ -20,6 +20,6 @@ git-bug comment [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-* [git-bug comment add](git-bug_comment_add.md)	 - Add a new comment to a bug
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug comment add](git-bug_comment_add.md)	 - Add a new comment
 
diff --git a/doc/md/git-bug_comment_add.md b/doc/md/git-bug_comment_add.md
index 678f910e..bdb5e8ae 100644
--- a/doc/md/git-bug_comment_add.md
+++ b/doc/md/git-bug_comment_add.md
@@ -1,10 +1,10 @@
 ## git-bug comment add
 
-Add a new comment to a bug
+Add a new comment
 
 ### Synopsis
 
-Add a new comment to a bug
+Add a new comment
 
 ```
 git-bug comment add [<id>] [flags]
@@ -18,5 +18,5 @@ git-bug comment add [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug comment](git-bug_comment.md)	 - Show a bug's comments
+* [git-bug comment](git-bug_comment.md)	 - Display or add comments
 
diff --git a/doc/md/git-bug_label.md b/doc/md/git-bug_label.md
index 3f68e067..9c214fe9 100644
--- a/doc/md/git-bug_label.md
+++ b/doc/md/git-bug_label.md
@@ -1,10 +1,10 @@
 ## git-bug label
 
-Display a bug labels
+Display, add or remove labels
 
 ### Synopsis
 
-Display a bug labels
+Display, add or remove labels
 
 ```
 git-bug label [<id>] [flags]
@@ -18,7 +18,7 @@ git-bug label [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-* [git-bug label add](git-bug_label_add.md)	 - Add a label to a bug
-* [git-bug label rm](git-bug_label_rm.md)	 - Remove a label from a bug
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug label add](git-bug_label_add.md)	 - Add a label
+* [git-bug label rm](git-bug_label_rm.md)	 - Remove a label
 
diff --git a/doc/md/git-bug_label_add.md b/doc/md/git-bug_label_add.md
index afe3e803..f37cc080 100644
--- a/doc/md/git-bug_label_add.md
+++ b/doc/md/git-bug_label_add.md
@@ -1,10 +1,10 @@
 ## git-bug label add
 
-Add a label to a bug
+Add a label
 
 ### Synopsis
 
-Add a label to a bug
+Add a label
 
 ```
 git-bug label add [<id>] <label>[...] [flags]
@@ -18,5 +18,5 @@ git-bug label add [<id>] <label>[...] [flags]
 
 ### SEE ALSO
 
-* [git-bug label](git-bug_label.md)	 - Display a bug labels
+* [git-bug label](git-bug_label.md)	 - Display, add or remove labels
 
diff --git a/doc/md/git-bug_label_rm.md b/doc/md/git-bug_label_rm.md
index 7721a2ba..19e664f8 100644
--- a/doc/md/git-bug_label_rm.md
+++ b/doc/md/git-bug_label_rm.md
@@ -1,10 +1,10 @@
 ## git-bug label rm
 
-Remove a label from a bug
+Remove a label
 
 ### Synopsis
 
-Remove a label from a bug
+Remove a label
 
 ```
 git-bug label rm [<id>] <label>[...] [flags]
@@ -18,5 +18,5 @@ git-bug label rm [<id>] <label>[...] [flags]
 
 ### SEE ALSO
 
-* [git-bug label](git-bug_label.md)	 - Display a bug labels
+* [git-bug label](git-bug_label.md)	 - Display, add or remove labels
 
diff --git a/doc/md/git-bug_ls.md b/doc/md/git-bug_ls.md
index a1ebad20..a9a2994a 100644
--- a/doc/md/git-bug_ls.md
+++ b/doc/md/git-bug_ls.md
@@ -37,5 +37,5 @@ git bug ls --status closed --by creation
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_pull.md b/doc/md/git-bug_pull.md
index 63e61f70..dad75b8b 100644
--- a/doc/md/git-bug_pull.md
+++ b/doc/md/git-bug_pull.md
@@ -18,5 +18,5 @@ git-bug pull [<remote>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_push.md b/doc/md/git-bug_push.md
index 98e8807b..1ea996ed 100644
--- a/doc/md/git-bug_push.md
+++ b/doc/md/git-bug_push.md
@@ -18,5 +18,5 @@ git-bug push [<remote>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_select.md b/doc/md/git-bug_select.md
index 963cfb24..6831496d 100644
--- a/doc/md/git-bug_select.md
+++ b/doc/md/git-bug_select.md
@@ -27,5 +27,5 @@ git bug status
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_show.md b/doc/md/git-bug_show.md
index 4ff7c833..4749e009 100644
--- a/doc/md/git-bug_show.md
+++ b/doc/md/git-bug_show.md
@@ -18,5 +18,5 @@ git-bug show [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_status.md b/doc/md/git-bug_status.md
index 284c9257..5a1c1f4a 100644
--- a/doc/md/git-bug_status.md
+++ b/doc/md/git-bug_status.md
@@ -1,10 +1,10 @@
 ## git-bug status
 
-Show the bug status
+Display or change a bug status
 
 ### Synopsis
 
-Show the bug status
+Display or change a bug status
 
 ```
 git-bug status [<id>] [flags]
@@ -18,7 +18,7 @@ git-bug status [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-* [git-bug status close](git-bug_status_close.md)	 - Mark the bug as closed
-* [git-bug status open](git-bug_status_open.md)	 - Mark the bug as open
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug status close](git-bug_status_close.md)	 - Mark a bug as closed
+* [git-bug status open](git-bug_status_open.md)	 - Mark a bug as open
 
diff --git a/doc/md/git-bug_status_close.md b/doc/md/git-bug_status_close.md
index a8e0f47b..e0655338 100644
--- a/doc/md/git-bug_status_close.md
+++ b/doc/md/git-bug_status_close.md
@@ -1,10 +1,10 @@
 ## git-bug status close
 
-Mark the bug as closed
+Mark a bug as closed
 
 ### Synopsis
 
-Mark the bug as closed
+Mark a bug as closed
 
 ```
 git-bug status close [<id>] [flags]
@@ -18,5 +18,5 @@ git-bug status close [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug status](git-bug_status.md)	 - Show the bug status
+* [git-bug status](git-bug_status.md)	 - Display or change a bug status
 
diff --git a/doc/md/git-bug_status_open.md b/doc/md/git-bug_status_open.md
index ac44e293..3763d4cd 100644
--- a/doc/md/git-bug_status_open.md
+++ b/doc/md/git-bug_status_open.md
@@ -1,10 +1,10 @@
 ## git-bug status open
 
-Mark the bug as open
+Mark a bug as open
 
 ### Synopsis
 
-Mark the bug as open
+Mark a bug as open
 
 ```
 git-bug status open [<id>] [flags]
@@ -18,5 +18,5 @@ git-bug status open [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug status](git-bug_status.md)	 - Show the bug status
+* [git-bug status](git-bug_status.md)	 - Display or change a bug status
 
diff --git a/doc/md/git-bug_termui.md b/doc/md/git-bug_termui.md
index 8bbca0fb..53ed49e5 100644
--- a/doc/md/git-bug_termui.md
+++ b/doc/md/git-bug_termui.md
@@ -18,5 +18,5 @@ git-bug termui [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
 
diff --git a/doc/md/git-bug_title.md b/doc/md/git-bug_title.md
index 62419866..85a5d9f7 100644
--- a/doc/md/git-bug_title.md
+++ b/doc/md/git-bug_title.md
@@ -1,10 +1,10 @@
 ## git-bug title
 
-Display a bug's title
+Display or change a title
 
 ### Synopsis
 
-Display a bug's title
+Display or change a title
 
 ```
 git-bug title [<id>] [flags]
@@ -18,6 +18,6 @@ git-bug title [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-* [git-bug title edit](git-bug_title_edit.md)	 - Edit a bug title
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug title edit](git-bug_title_edit.md)	 - Edit a title
 
diff --git a/doc/md/git-bug_title_edit.md b/doc/md/git-bug_title_edit.md
index 781b0b9b..dc463390 100644
--- a/doc/md/git-bug_title_edit.md
+++ b/doc/md/git-bug_title_edit.md
@@ -1,10 +1,10 @@
 ## git-bug title edit
 
-Edit a bug title
+Edit a title
 
 ### Synopsis
 
-Edit a bug title
+Edit a title
 
 ```
 git-bug title edit [<id>] [flags]
@@ -19,5 +19,5 @@ git-bug title edit [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug title](git-bug_title.md)	 - Display a bug's title
+* [git-bug title](git-bug_title.md)	 - Display or change a title
 
diff --git a/doc/md/git-bug_webui.md b/doc/md/git-bug_webui.md
index 83c88a26..670130aa 100644
--- a/doc/md/git-bug_webui.md
+++ b/doc/md/git-bug_webui.md
@@ -19,5 +19,5 @@ git-bug webui [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git