From 2fd5f71b592eeebd0c0c4c770a7dac88d7eae80a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20Mur=C3=A9?= <batolettre@gmail.com>
Date: Sun, 24 Feb 2019 14:46:08 +0100
Subject: [PATCH] commands: add a "." at the end of Short commands usage

---
 commands/add.go                    |  2 +-
 commands/bridge.go                 |  2 +-
 commands/bridge_configure.go       |  2 +-
 commands/bridge_pull.go            |  2 +-
 commands/bridge_rm.go              |  2 +-
 commands/commands.go               |  2 +-
 commands/comment.go                |  2 +-
 commands/comment_add.go            |  2 +-
 commands/deselect.go               |  2 +-
 commands/label.go                  |  2 +-
 commands/label_add.go              |  2 +-
 commands/label_rm.go               |  2 +-
 commands/ls-labels.go              |  2 +-
 commands/ls.go                     |  2 +-
 commands/pull.go                   |  2 +-
 commands/push.go                   |  2 +-
 commands/root.go                   |  2 +-
 commands/select.go                 |  2 +-
 commands/show.go                   |  2 +-
 commands/status.go                 |  2 +-
 commands/status_close.go           |  2 +-
 commands/status_open.go            |  2 +-
 commands/termui.go                 |  2 +-
 commands/title.go                  |  2 +-
 commands/title_edit.go             |  2 +-
 commands/user.go                   |  2 +-
 commands/user_create.go            |  2 +-
 commands/user_list.go              |  2 +-
 commands/version.go                |  2 +-
 commands/webui.go                  |  2 +-
 doc/man/git-bug-ls-id.1            | 29 +++++++++++++++++++++++
 doc/md/git-bug.md                  | 38 +++++++++++++++---------------
 doc/md/git-bug_add.md              |  6 ++---
 doc/md/git-bug_bridge.md           | 12 +++++-----
 doc/md/git-bug_bridge_configure.md |  6 ++---
 doc/md/git-bug_bridge_pull.md      |  6 ++---
 doc/md/git-bug_bridge_rm.md        |  6 ++---
 doc/md/git-bug_commands.md         |  6 ++---
 doc/md/git-bug_comment.md          |  8 +++----
 doc/md/git-bug_comment_add.md      |  6 ++---
 doc/md/git-bug_deselect.md         |  6 ++---
 doc/md/git-bug_label.md            | 10 ++++----
 doc/md/git-bug_label_add.md        |  6 ++---
 doc/md/git-bug_label_rm.md         |  6 ++---
 doc/md/git-bug_ls-id.md            | 22 +++++++++++++++++
 doc/md/git-bug_ls-label.md         |  4 ++--
 doc/md/git-bug_ls.md               |  4 ++--
 doc/md/git-bug_pull.md             |  6 ++---
 doc/md/git-bug_push.md             |  6 ++---
 doc/md/git-bug_select.md           |  6 ++---
 doc/md/git-bug_show.md             |  6 ++---
 doc/md/git-bug_status.md           | 10 ++++----
 doc/md/git-bug_status_close.md     |  6 ++---
 doc/md/git-bug_status_open.md      |  6 ++---
 doc/md/git-bug_termui.md           |  6 ++---
 doc/md/git-bug_title.md            |  8 +++----
 doc/md/git-bug_title_edit.md       |  6 ++---
 doc/md/git-bug_user.md             | 11 +++++----
 doc/md/git-bug_user_create.md      |  6 ++---
 doc/md/git-bug_user_ls.md          |  6 ++---
 doc/md/git-bug_version.md          |  6 ++---
 doc/md/git-bug_webui.md            |  6 ++---
 62 files changed, 197 insertions(+), 145 deletions(-)
 create mode 100644 doc/man/git-bug-ls-id.1
 create mode 100644 doc/md/git-bug_ls-id.md

diff --git a/commands/add.go b/commands/add.go
index 54ede1260daaa6f3e0cd9d12725ec9ca970a7a3b..ea40227cb397972a3bb6f81e590dce01e3444ca1 100644
--- a/commands/add.go
+++ b/commands/add.go
@@ -56,7 +56,7 @@ func runAddBug(cmd *cobra.Command, args []string) error {
 
 var addCmd = &cobra.Command{
 	Use:     "add",
-	Short:   "Create a new bug",
+	Short:   "Create a new bug.",
 	PreRunE: loadRepo,
 	RunE:    runAddBug,
 }
diff --git a/commands/bridge.go b/commands/bridge.go
index a473776d7eaa1692e93d5ddb355c1ffe3da4b0fc..2566fd068b07e4e2ba654e379b7f059c7eb97deb 100644
--- a/commands/bridge.go
+++ b/commands/bridge.go
@@ -31,7 +31,7 @@ func runBridge(cmd *cobra.Command, args []string) error {
 
 var bridgeCmd = &cobra.Command{
 	Use:     "bridge",
-	Short:   "Configure and use bridges to other bug trackers",
+	Short:   "Configure and use bridges to other bug trackers.",
 	PreRunE: loadRepo,
 	RunE:    runBridge,
 	Args:    cobra.NoArgs,
diff --git a/commands/bridge_configure.go b/commands/bridge_configure.go
index ef499f1ff59b97dee3fe05cc98fe6706ca228c5a..ce10d9af69a3bebd3dbb18c150332f3397775eff 100644
--- a/commands/bridge_configure.go
+++ b/commands/bridge_configure.go
@@ -91,7 +91,7 @@ func promptName() (string, error) {
 
 var bridgeConfigureCmd = &cobra.Command{
 	Use:     "configure",
-	Short:   "Configure a new bridge",
+	Short:   "Configure a new bridge.",
 	PreRunE: loadRepo,
 	RunE:    runBridgeConfigure,
 }
diff --git a/commands/bridge_pull.go b/commands/bridge_pull.go
index 669a67133b0ddd6b26386c7bf23d7d0fda841368..9b25147908e44183007cdc21af7f227a81cc15b0 100644
--- a/commands/bridge_pull.go
+++ b/commands/bridge_pull.go
@@ -38,7 +38,7 @@ func runBridgePull(cmd *cobra.Command, args []string) error {
 
 var bridgePullCmd = &cobra.Command{
 	Use:     "pull [<name>]",
-	Short:   "Pull updates",
+	Short:   "Pull updates.",
 	PreRunE: loadRepo,
 	RunE:    runBridgePull,
 }
diff --git a/commands/bridge_rm.go b/commands/bridge_rm.go
index 172fc0d8d2ff214789e69f80565542e787679ed6..80a831ff3e626479345625f472adb4626333154d 100644
--- a/commands/bridge_rm.go
+++ b/commands/bridge_rm.go
@@ -25,7 +25,7 @@ func runBridgeRm(cmd *cobra.Command, args []string) error {
 
 var bridgeRmCmd = &cobra.Command{
 	Use:     "rm name <name>",
-	Short:   "Delete a configured bridge",
+	Short:   "Delete a configured bridge.",
 	PreRunE: loadRepo,
 	RunE:    runBridgeRm,
 	Args:    cobra.ExactArgs(1),
diff --git a/commands/commands.go b/commands/commands.go
index e48cd542d85e49757d58086ed4389d7d8b74eb89..a30c38a50971f8e930aac24ccc6268dd8bd5bd42 100644
--- a/commands/commands.go
+++ b/commands/commands.go
@@ -61,7 +61,7 @@ func runCommands(cmd *cobra.Command, args []string) error {
 
 var commandsCmd = &cobra.Command{
 	Use:   "commands [<option>...]",
-	Short: "Display available commands",
+	Short: "Display available commands.",
 	RunE:  runCommands,
 }
 
diff --git a/commands/comment.go b/commands/comment.go
index 89378da30271c5ad746d545356fc059ecd72c9af..3d5fe4eb2319eb77ebfdfa95e5fbdf1f973ed989 100644
--- a/commands/comment.go
+++ b/commands/comment.go
@@ -46,7 +46,7 @@ func commentsTextOutput(comments []bug.Comment) {
 
 var commentCmd = &cobra.Command{
 	Use:     "comment [<id>]",
-	Short:   "Display or add comments",
+	Short:   "Display or add comments.",
 	PreRunE: loadRepo,
 	RunE:    runComment,
 }
diff --git a/commands/comment_add.go b/commands/comment_add.go
index 80955da527911c2e1995e2c56150a552d7c762d4..9bb2408614452df3319f302121e63dd5cdf2563a 100644
--- a/commands/comment_add.go
+++ b/commands/comment_add.go
@@ -56,7 +56,7 @@ func runCommentAdd(cmd *cobra.Command, args []string) error {
 
 var commentAddCmd = &cobra.Command{
 	Use:     "add [<id>]",
-	Short:   "Add a new comment",
+	Short:   "Add a new comment.",
 	PreRunE: loadRepo,
 	RunE:    runCommentAdd,
 }
diff --git a/commands/deselect.go b/commands/deselect.go
index 210f158c1b7638d651c5a09aae669163ab8fe1dc..f92c81fdedd59f0d0a6d9de0ed0d5a8967f7b033 100644
--- a/commands/deselect.go
+++ b/commands/deselect.go
@@ -25,7 +25,7 @@ func runDeselect(cmd *cobra.Command, args []string) error {
 
 var deselectCmd = &cobra.Command{
 	Use:   "deselect",
-	Short: "Clear the implicitly selected bug",
+	Short: "Clear the implicitly selected bug.",
 	Example: `git bug select 2f15
 git bug comment
 git bug status
diff --git a/commands/label.go b/commands/label.go
index 58ccc299f098c3a9638ace473f7f682474a91311..4f15c893b72efaad219ba9b2a9676791d8c20c3b 100644
--- a/commands/label.go
+++ b/commands/label.go
@@ -33,7 +33,7 @@ func runLabel(cmd *cobra.Command, args []string) error {
 
 var labelCmd = &cobra.Command{
 	Use:     "label [<id>]",
-	Short:   "Display, add or remove labels",
+	Short:   "Display, add or remove labels.",
 	PreRunE: loadRepo,
 	RunE:    runLabel,
 }
diff --git a/commands/label_add.go b/commands/label_add.go
index 2b80831129e504014980c76579668f9394e20be7..b936bc3701f48002e97b783407812054902dabef 100644
--- a/commands/label_add.go
+++ b/commands/label_add.go
@@ -37,7 +37,7 @@ func runLabelAdd(cmd *cobra.Command, args []string) error {
 
 var labelAddCmd = &cobra.Command{
 	Use:     "add [<id>] <label>[...]",
-	Short:   "Add a label",
+	Short:   "Add a label.",
 	PreRunE: loadRepo,
 	RunE:    runLabelAdd,
 }
diff --git a/commands/label_rm.go b/commands/label_rm.go
index 6b48fe72646cb9a2e99b7e995e5c67e784a7f5be..c03a20d9f59f125eda8c1ff44a345ee41bd81955 100644
--- a/commands/label_rm.go
+++ b/commands/label_rm.go
@@ -37,7 +37,7 @@ func runLabelRm(cmd *cobra.Command, args []string) error {
 
 var labelRmCmd = &cobra.Command{
 	Use:     "rm [<id>] <label>[...]",
-	Short:   "Remove a label",
+	Short:   "Remove a label.",
 	PreRunE: loadRepo,
 	RunE:    runLabelRm,
 }
diff --git a/commands/ls-labels.go b/commands/ls-labels.go
index ef2c95bcc3fc866551165ccae4ecce3c4944de61..5610fb561c2825fd02022d99b043f3c0cee7a777 100644
--- a/commands/ls-labels.go
+++ b/commands/ls-labels.go
@@ -27,7 +27,7 @@ func runLsLabel(cmd *cobra.Command, args []string) error {
 
 var lsLabelCmd = &cobra.Command{
 	Use:   "ls-label",
-	Short: "List valid labels",
+	Short: "List valid labels.",
 	Long: `List valid labels.
 
 Note: in the future, a proper label policy could be implemented where valid labels are defined in a configuration file. Until that, the default behavior is to return the list of labels already used.`,
diff --git a/commands/ls.go b/commands/ls.go
index f641b58abe801b37c33bd79c569a114eeb631400..75b7ceaf6ea61167e987d99844b340a4a9ad6321 100644
--- a/commands/ls.go
+++ b/commands/ls.go
@@ -131,7 +131,7 @@ func lsQueryFromFlags() (*cache.Query, error) {
 
 var lsCmd = &cobra.Command{
 	Use:   "ls [<query>]",
-	Short: "List bugs",
+	Short: "List bugs.",
 	Long: `Display a summary of each bugs.
 
 You can pass an additional query to filter and order the list. This query can be expressed either with a simple query language or with flags.`,
diff --git a/commands/pull.go b/commands/pull.go
index 67c2a3398a0a8a7fab90d6f16097d28c411c6c88..d2d75f3f19b039afcb139c8cd96c088e8cde0d76 100644
--- a/commands/pull.go
+++ b/commands/pull.go
@@ -54,7 +54,7 @@ func runPull(cmd *cobra.Command, args []string) error {
 // showCmd defines the "push" subcommand.
 var pullCmd = &cobra.Command{
 	Use:     "pull [<remote>]",
-	Short:   "Pull bugs update from a git remote",
+	Short:   "Pull bugs update from a git remote.",
 	PreRunE: loadRepo,
 	RunE:    runPull,
 }
diff --git a/commands/push.go b/commands/push.go
index 0477be60a5545ac6a583aea0fbf67e25a263d254..8f67d3c09f1e28dc639f34a8362a081e20db1188 100644
--- a/commands/push.go
+++ b/commands/push.go
@@ -39,7 +39,7 @@ func runPush(cmd *cobra.Command, args []string) error {
 // showCmd defines the "push" subcommand.
 var pushCmd = &cobra.Command{
 	Use:     "push [<remote>]",
-	Short:   "Push bugs update to a git remote",
+	Short:   "Push bugs update to a git remote.",
 	PreRunE: loadRepo,
 	RunE:    runPush,
 }
diff --git a/commands/root.go b/commands/root.go
index 04bd6a83a301941022697bcea985111ff456b0f2..adbf51d97fb6febc0fe993cff0ea2bf1216b163b 100644
--- a/commands/root.go
+++ b/commands/root.go
@@ -19,7 +19,7 @@ var repo repository.ClockedRepo
 // RootCmd represents the base command when called without any subcommands
 var RootCmd = &cobra.Command{
 	Use:   rootCommandName,
-	Short: "A bug tracker embedded in Git",
+	Short: "A bug tracker embedded in Git.",
 	Long: `git-bug is a bug tracker embedded in git.
 
 git-bug use git objects to store the bug tracking separated from the files
diff --git a/commands/select.go b/commands/select.go
index cc6883540cb7f7525b7c65d4e600f5803b82a6aa..6b2149615b70a0ed0e90c1fc6d518ba1a0c527ee 100644
--- a/commands/select.go
+++ b/commands/select.go
@@ -41,7 +41,7 @@ func runSelect(cmd *cobra.Command, args []string) error {
 
 var selectCmd = &cobra.Command{
 	Use:   "select <id>",
-	Short: "Select a bug for implicit use in future commands",
+	Short: "Select a bug for implicit use in future commands.",
 	Example: `git bug select 2f15
 git bug comment
 git bug status
diff --git a/commands/show.go b/commands/show.go
index 3adc8b520f5151f641902ed0131361a97cbe7765..c62db1a160d55a8e725c6be7086d3690d96982ec 100644
--- a/commands/show.go
+++ b/commands/show.go
@@ -113,7 +113,7 @@ func runShowBug(cmd *cobra.Command, args []string) error {
 
 var showCmd = &cobra.Command{
 	Use:     "show [<id>]",
-	Short:   "Display the details of a bug",
+	Short:   "Display the details of a bug.",
 	PreRunE: loadRepo,
 	RunE:    runShowBug,
 }
diff --git a/commands/status.go b/commands/status.go
index 7928628a751eab19cf6b8daa1faeeb319266d060..4675195d59798b40b45af22889e0784b6684b1c6 100644
--- a/commands/status.go
+++ b/commands/status.go
@@ -31,7 +31,7 @@ func runStatus(cmd *cobra.Command, args []string) error {
 
 var statusCmd = &cobra.Command{
 	Use:     "status [<id>]",
-	Short:   "Display or change a bug status",
+	Short:   "Display or change a bug status.",
 	PreRunE: loadRepo,
 	RunE:    runStatus,
 }
diff --git a/commands/status_close.go b/commands/status_close.go
index 03618cc610c58833a5c5f7966d6c0d3a285d558e..94d05ddf5a3a81f7ae72a075880f9493f04bea36 100644
--- a/commands/status_close.go
+++ b/commands/status_close.go
@@ -30,7 +30,7 @@ func runStatusClose(cmd *cobra.Command, args []string) error {
 
 var closeCmd = &cobra.Command{
 	Use:     "close [<id>]",
-	Short:   "Mark a bug as closed",
+	Short:   "Mark a bug as closed.",
 	PreRunE: loadRepo,
 	RunE:    runStatusClose,
 }
diff --git a/commands/status_open.go b/commands/status_open.go
index f19847db483dd12ef0f389c5b117693f80f9d48c..9a2b76ab9381fec11c4d6825b23955a81ce0a34a 100644
--- a/commands/status_open.go
+++ b/commands/status_open.go
@@ -30,7 +30,7 @@ func runStatusOpen(cmd *cobra.Command, args []string) error {
 
 var openCmd = &cobra.Command{
 	Use:     "open [<id>]",
-	Short:   "Mark a bug as open",
+	Short:   "Mark a bug as open.",
 	PreRunE: loadRepo,
 	RunE:    runStatusOpen,
 }
diff --git a/commands/termui.go b/commands/termui.go
index abfd165fb6a4a95d3f63add6729add62f03e847c..19a1397a8040c193aabce2fe53af980e20157ca1 100644
--- a/commands/termui.go
+++ b/commands/termui.go
@@ -20,7 +20,7 @@ func runTermUI(cmd *cobra.Command, args []string) error {
 
 var termUICmd = &cobra.Command{
 	Use:     "termui",
-	Short:   "Launch the terminal UI",
+	Short:   "Launch the terminal UI.",
 	PreRunE: loadRepoEnsureUser,
 	RunE:    runTermUI,
 }
diff --git a/commands/title.go b/commands/title.go
index c9157a7066201ebffbb66e55fcac934df459be5e..f9b7542bd7775e9d0c0ab4b824a1120def677f0d 100644
--- a/commands/title.go
+++ b/commands/title.go
@@ -31,7 +31,7 @@ func runTitle(cmd *cobra.Command, args []string) error {
 
 var titleCmd = &cobra.Command{
 	Use:     "title [<id>]",
-	Short:   "Display or change a title",
+	Short:   "Display or change a title.",
 	PreRunE: loadRepo,
 	RunE:    runTitle,
 }
diff --git a/commands/title_edit.go b/commands/title_edit.go
index 8848e7a8da2a46d2ab392d75a8aca33ef528b36a..e95c77d03604947c084fb4dafd9f5bcd3238987f 100644
--- a/commands/title_edit.go
+++ b/commands/title_edit.go
@@ -54,7 +54,7 @@ func runTitleEdit(cmd *cobra.Command, args []string) error {
 
 var titleEditCmd = &cobra.Command{
 	Use:     "edit [<id>]",
-	Short:   "Edit a title",
+	Short:   "Edit a title.",
 	PreRunE: loadRepo,
 	RunE:    runTitleEdit,
 }
diff --git a/commands/user.go b/commands/user.go
index 64482555e5d265b9e3fa20ea3c267f6b44a42581..daf9e654befe7fb8c4c31ac2f6d70740d5febc35 100644
--- a/commands/user.go
+++ b/commands/user.go
@@ -43,7 +43,7 @@ func runUser(cmd *cobra.Command, args []string) error {
 
 var userCmd = &cobra.Command{
 	Use:     "user [<id>]",
-	Short:   "Display or change the user identity",
+	Short:   "Display or change the user identity.",
 	PreRunE: loadRepo,
 	RunE:    runUser,
 }
diff --git a/commands/user_create.go b/commands/user_create.go
index 00ec5b9b409cfdb3272e126ef77b86091b44e26b..037d79b256c0c39632fbd733d1b6d48274bb5226 100644
--- a/commands/user_create.go
+++ b/commands/user_create.go
@@ -70,7 +70,7 @@ func runUserCreate(cmd *cobra.Command, args []string) error {
 
 var userCreateCmd = &cobra.Command{
 	Use:     "create",
-	Short:   "Create a new identity",
+	Short:   "Create a new identity.",
 	PreRunE: loadRepo,
 	RunE:    runUserCreate,
 }
diff --git a/commands/user_list.go b/commands/user_list.go
index 4d6e5e12c3dffab990bbd900f3f384a9a2053b4f..63717ce39d0fd8bdcc913468b1d71f3ed46d3d1f 100644
--- a/commands/user_list.go
+++ b/commands/user_list.go
@@ -33,7 +33,7 @@ func runUserLs(cmd *cobra.Command, args []string) error {
 
 var userLsCmd = &cobra.Command{
 	Use:     "ls",
-	Short:   "List identities",
+	Short:   "List identities.",
 	PreRunE: loadRepo,
 	RunE:    runUserLs,
 }
diff --git a/commands/version.go b/commands/version.go
index b4dc008eaeef36361dbd6332febd3965fc296fc8..05016a0be061c0d401829b902710567a3af055d4 100644
--- a/commands/version.go
+++ b/commands/version.go
@@ -41,7 +41,7 @@ func runVersionCmd(cmd *cobra.Command, args []string) {
 
 var versionCmd = &cobra.Command{
 	Use:   "version",
-	Short: "Show git-bug version information",
+	Short: "Show git-bug version information.",
 	Run:   runVersionCmd,
 }
 
diff --git a/commands/webui.go b/commands/webui.go
index e2a3265c35acec4d55786fa7a56e9f2d13f91df8..f86616d5e9f58dd216d5cb4041272931e7313dc7 100644
--- a/commands/webui.go
+++ b/commands/webui.go
@@ -224,7 +224,7 @@ func (gufh *gitUploadFileHandler) ServeHTTP(rw http.ResponseWriter, r *http.Requ
 
 var webUICmd = &cobra.Command{
 	Use:     "webui",
-	Short:   "Launch the web UI",
+	Short:   "Launch the web UI.",
 	PreRunE: loadRepo,
 	RunE:    runWebUI,
 }
diff --git a/doc/man/git-bug-ls-id.1 b/doc/man/git-bug-ls-id.1
new file mode 100644
index 0000000000000000000000000000000000000000..aba67e1c1fffe0c16909b521441ddec07171a41e
--- /dev/null
+++ b/doc/man/git-bug-ls-id.1
@@ -0,0 +1,29 @@
+.TH "GIT-BUG" "1" "Mar 2019" "Generated from git-bug's source code" "" 
+.nh
+.ad l
+
+
+.SH NAME
+.PP
+git\-bug\-ls\-id \- List Bug Id
+
+
+.SH SYNOPSIS
+.PP
+\fBgit\-bug ls\-id [<prefix>] [flags]\fP
+
+
+.SH DESCRIPTION
+.PP
+List Bug Id
+
+
+.SH OPTIONS
+.PP
+\fB\-h\fP, \fB\-\-help\fP[=false]
+    help for ls\-id
+
+
+.SH SEE ALSO
+.PP
+\fBgit\-bug(1)\fP
diff --git a/doc/md/git-bug.md b/doc/md/git-bug.md
index a5f6103230195cd100158e9689941fae5525d7b0..1de9133b2d67620386d64373494ffd2ba8b30a4b 100644
--- a/doc/md/git-bug.md
+++ b/doc/md/git-bug.md
@@ -1,6 +1,6 @@
 ## git-bug
 
-A bug tracker embedded in Git
+A bug tracker embedded in Git.
 
 ### Synopsis
 
@@ -24,23 +24,23 @@ git-bug [flags]
 
 ### SEE ALSO
 
-* [git-bug add](git-bug_add.md)	 - Create a new bug
-* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers
-* [git-bug commands](git-bug_commands.md)	 - Display available commands
-* [git-bug comment](git-bug_comment.md)	 - Display or add comments
-* [git-bug deselect](git-bug_deselect.md)	 - Clear the implicitly selected bug
-* [git-bug label](git-bug_label.md)	 - Display, add or remove labels
-* [git-bug ls](git-bug_ls.md)	 - List bugs
+* [git-bug add](git-bug_add.md)	 - Create a new bug.
+* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers.
+* [git-bug commands](git-bug_commands.md)	 - Display available commands.
+* [git-bug comment](git-bug_comment.md)	 - Display or add comments.
+* [git-bug deselect](git-bug_deselect.md)	 - Clear the implicitly selected bug.
+* [git-bug label](git-bug_label.md)	 - Display, add or remove labels.
+* [git-bug ls](git-bug_ls.md)	 - List bugs.
 * [git-bug ls-id](git-bug_ls-id.md)	 - List Bug Id
-* [git-bug ls-label](git-bug_ls-label.md)	 - List valid labels
-* [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)	 - 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 or change a title
-* [git-bug user](git-bug_user.md)	 - Display or change the user identity
-* [git-bug version](git-bug_version.md)	 - Show git-bug version information
-* [git-bug webui](git-bug_webui.md)	 - Launch the web UI
+* [git-bug ls-label](git-bug_ls-label.md)	 - List valid labels.
+* [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)	 - 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 or change a title.
+* [git-bug user](git-bug_user.md)	 - Display or change the user identity.
+* [git-bug version](git-bug_version.md)	 - Show git-bug version information.
+* [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 d212c9b152c324baef0a7f6a6a0475b53894e783..c103cebb70e774f8d5ce779f7562449987839d1f 100644
--- a/doc/md/git-bug_add.md
+++ b/doc/md/git-bug_add.md
@@ -1,10 +1,10 @@
 ## git-bug add
 
-Create a new bug
+Create a new bug.
 
 ### Synopsis
 
-Create a new bug
+Create a new bug.
 
 ```
 git-bug add [flags]
@@ -21,5 +21,5 @@ git-bug add [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
 
diff --git a/doc/md/git-bug_bridge.md b/doc/md/git-bug_bridge.md
index da7f09780fa565c0c45c8e8e679d7bc113bcf64b..7d01a300866be3efba9e9c33d9b4d87214559ac3 100644
--- a/doc/md/git-bug_bridge.md
+++ b/doc/md/git-bug_bridge.md
@@ -1,10 +1,10 @@
 ## git-bug bridge
 
-Configure and use bridges to other bug trackers
+Configure and use bridges to other bug trackers.
 
 ### Synopsis
 
-Configure and use bridges to other bug trackers
+Configure and use bridges to other bug trackers.
 
 ```
 git-bug bridge [flags]
@@ -18,8 +18,8 @@ git-bug bridge [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
-* [git-bug bridge configure](git-bug_bridge_configure.md)	 - Configure a new bridge
-* [git-bug bridge pull](git-bug_bridge_pull.md)	 - Pull updates
-* [git-bug bridge rm](git-bug_bridge_rm.md)	 - Delete a configured bridge
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
+* [git-bug bridge configure](git-bug_bridge_configure.md)	 - Configure a new bridge.
+* [git-bug bridge pull](git-bug_bridge_pull.md)	 - Pull updates.
+* [git-bug bridge rm](git-bug_bridge_rm.md)	 - Delete a configured bridge.
 
diff --git a/doc/md/git-bug_bridge_configure.md b/doc/md/git-bug_bridge_configure.md
index ca66f500e3b89c2d841386529e1890ff7b57b9d8..63fbbbca1ca6cdc6ab282841c7f27fda10b7dea0 100644
--- a/doc/md/git-bug_bridge_configure.md
+++ b/doc/md/git-bug_bridge_configure.md
@@ -1,10 +1,10 @@
 ## git-bug bridge configure
 
-Configure a new bridge
+Configure a new bridge.
 
 ### Synopsis
 
-Configure a new bridge
+Configure a new bridge.
 
 ```
 git-bug bridge configure [flags]
@@ -18,5 +18,5 @@ git-bug bridge configure [flags]
 
 ### SEE ALSO
 
-* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers
+* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers.
 
diff --git a/doc/md/git-bug_bridge_pull.md b/doc/md/git-bug_bridge_pull.md
index 10da2e8a65cc6523e4cb90140455b301677d81e3..14b62f603ae6a60e5574c31c8d68b6c5b3176d59 100644
--- a/doc/md/git-bug_bridge_pull.md
+++ b/doc/md/git-bug_bridge_pull.md
@@ -1,10 +1,10 @@
 ## git-bug bridge pull
 
-Pull updates
+Pull updates.
 
 ### Synopsis
 
-Pull updates
+Pull updates.
 
 ```
 git-bug bridge pull [<name>] [flags]
@@ -18,5 +18,5 @@ git-bug bridge pull [<name>] [flags]
 
 ### SEE ALSO
 
-* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers
+* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers.
 
diff --git a/doc/md/git-bug_bridge_rm.md b/doc/md/git-bug_bridge_rm.md
index 15b20749134f129e4f7f821713d378a0dcea507a..ab58e96940e341b8e31e878892146d61fd918b2f 100644
--- a/doc/md/git-bug_bridge_rm.md
+++ b/doc/md/git-bug_bridge_rm.md
@@ -1,10 +1,10 @@
 ## git-bug bridge rm
 
-Delete a configured bridge
+Delete a configured bridge.
 
 ### Synopsis
 
-Delete a configured bridge
+Delete a configured bridge.
 
 ```
 git-bug bridge rm name <name> [flags]
@@ -18,5 +18,5 @@ git-bug bridge rm name <name> [flags]
 
 ### SEE ALSO
 
-* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers
+* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers.
 
diff --git a/doc/md/git-bug_commands.md b/doc/md/git-bug_commands.md
index 6d777b4076037c8a2112488febbff23f0c062b00..e1a409d270d75b6165d18ee61b3a6e6a7c5b302e 100644
--- a/doc/md/git-bug_commands.md
+++ b/doc/md/git-bug_commands.md
@@ -1,10 +1,10 @@
 ## git-bug commands
 
-Display available commands
+Display available commands.
 
 ### Synopsis
 
-Display available commands
+Display available commands.
 
 ```
 git-bug commands [<option>...] [flags]
@@ -19,5 +19,5 @@ git-bug commands [<option>...] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 0ffd9e96785e652a45e7476db614e22861efe7ea..31a80e51249482417f307fec536f84734e8f4c82 100644
--- a/doc/md/git-bug_comment.md
+++ b/doc/md/git-bug_comment.md
@@ -1,10 +1,10 @@
 ## git-bug comment
 
-Display or add comments
+Display or add comments.
 
 ### Synopsis
 
-Display or add comments
+Display or add comments.
 
 ```
 git-bug comment [<id>] [flags]
@@ -18,6 +18,6 @@ git-bug comment [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
-* [git-bug comment add](git-bug_comment_add.md)	 - Add a new comment
+* [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 7b8e5043b989ad041a7ea0ac84e551f8df708422..5a1e429e1a72e44c18904e302e46da55840170d6 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
+Add a new comment.
 
 ### Synopsis
 
-Add a new comment
+Add a new comment.
 
 ```
 git-bug comment add [<id>] [flags]
@@ -20,5 +20,5 @@ git-bug comment add [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug comment](git-bug_comment.md)	 - Display or add comments
+* [git-bug comment](git-bug_comment.md)	 - Display or add comments.
 
diff --git a/doc/md/git-bug_deselect.md b/doc/md/git-bug_deselect.md
index dbc86dc9b862f756b1d9464b99660cff08f3545b..7cf667b005ffd97513f91aeaf8e808e09e44b3e0 100644
--- a/doc/md/git-bug_deselect.md
+++ b/doc/md/git-bug_deselect.md
@@ -1,10 +1,10 @@
 ## git-bug deselect
 
-Clear the implicitly selected bug
+Clear the implicitly selected bug.
 
 ### Synopsis
 
-Clear the implicitly selected bug
+Clear the implicitly selected bug.
 
 ```
 git-bug deselect [flags]
@@ -28,5 +28,5 @@ git bug deselect
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
 
diff --git a/doc/md/git-bug_label.md b/doc/md/git-bug_label.md
index 9c214fe92fd6263aa6eb61217b5eb6ff3d049cbb..df2cae5ac7bb13e06af95f27bed6a813449fd95a 100644
--- a/doc/md/git-bug_label.md
+++ b/doc/md/git-bug_label.md
@@ -1,10 +1,10 @@
 ## git-bug label
 
-Display, add or remove labels
+Display, add or remove labels.
 
 ### Synopsis
 
-Display, add or remove 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 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
+* [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 f37cc08005caa25e8c1a28656dc5bd39b09381e3..9e642734f31b071480b2241cf4f9843bb4ee1303 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
+Add a label.
 
 ### Synopsis
 
-Add a label
+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, add or remove 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 19e664f8e8722b7f72215148b7d6ec9f350ae9a1..850b4d5807806c2c521bd7b28845d058a03faad1 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
+Remove a label.
 
 ### Synopsis
 
-Remove a label
+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, add or remove labels
+* [git-bug label](git-bug_label.md)	 - Display, add or remove labels.
 
diff --git a/doc/md/git-bug_ls-id.md b/doc/md/git-bug_ls-id.md
new file mode 100644
index 0000000000000000000000000000000000000000..2e99f134aadde0c1c81763ee00521a77d64f8ebf
--- /dev/null
+++ b/doc/md/git-bug_ls-id.md
@@ -0,0 +1,22 @@
+## git-bug ls-id
+
+List Bug Id
+
+### Synopsis
+
+List Bug Id
+
+```
+git-bug ls-id [<prefix>] [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for ls-id
+```
+
+### SEE ALSO
+
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
+
diff --git a/doc/md/git-bug_ls-label.md b/doc/md/git-bug_ls-label.md
index f3b82f4f45aa8e36999067b778e9d4321a26392e..9ee6fa8c68b3b81d0016d83fcce36a0c8fe551b1 100644
--- a/doc/md/git-bug_ls-label.md
+++ b/doc/md/git-bug_ls-label.md
@@ -1,6 +1,6 @@
 ## git-bug ls-label
 
-List valid labels
+List valid labels.
 
 ### Synopsis
 
@@ -20,5 +20,5 @@ git-bug ls-label [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
 
diff --git a/doc/md/git-bug_ls.md b/doc/md/git-bug_ls.md
index a9a2994a37c94607486be5636832dd8bea11bf85..18ac5d61142ac7e82dd1b3cabbe138fe7691c300 100644
--- a/doc/md/git-bug_ls.md
+++ b/doc/md/git-bug_ls.md
@@ -1,6 +1,6 @@
 ## git-bug ls
 
-List bugs
+List bugs.
 
 ### Synopsis
 
@@ -37,5 +37,5 @@ git bug ls --status closed --by creation
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 dad75b8bb944ca2b436092fb6bd0dd3678345bc0..1519c87fd7c357e68c788ece48acfbf5d2e761d2 100644
--- a/doc/md/git-bug_pull.md
+++ b/doc/md/git-bug_pull.md
@@ -1,10 +1,10 @@
 ## git-bug pull
 
-Pull bugs update from a git remote
+Pull bugs update from a git remote.
 
 ### Synopsis
 
-Pull bugs update from a git remote
+Pull bugs update from a git remote.
 
 ```
 git-bug pull [<remote>] [flags]
@@ -18,5 +18,5 @@ git-bug pull [<remote>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 1ea996ede76e4987e9b87d27ef4903e9ff3f14bd..5e95ea2f3a7c9762674920ed464efcee357c3f32 100644
--- a/doc/md/git-bug_push.md
+++ b/doc/md/git-bug_push.md
@@ -1,10 +1,10 @@
 ## git-bug push
 
-Push bugs update to a git remote
+Push bugs update to a git remote.
 
 ### Synopsis
 
-Push bugs update to a git remote
+Push bugs update to a git remote.
 
 ```
 git-bug push [<remote>] [flags]
@@ -18,5 +18,5 @@ git-bug push [<remote>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 6831496db95d964c1ba86195a6a118231bd90362..c81253809ce4cbdedac9a0099e8664bc79f48483 100644
--- a/doc/md/git-bug_select.md
+++ b/doc/md/git-bug_select.md
@@ -1,10 +1,10 @@
 ## git-bug select
 
-Select a bug for implicit use in future commands
+Select a bug for implicit use in future commands.
 
 ### Synopsis
 
-Select a bug for implicit use in future commands
+Select a bug for implicit use in future commands.
 
 ```
 git-bug select <id> [flags]
@@ -27,5 +27,5 @@ git bug status
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 677ce9cd91ad74c04a9e70f52d82db231a7c9453..86f3cfce56787b50178e8701684d2b91b3d62dc1 100644
--- a/doc/md/git-bug_show.md
+++ b/doc/md/git-bug_show.md
@@ -1,10 +1,10 @@
 ## git-bug show
 
-Display the details of a bug
+Display the details of a bug.
 
 ### Synopsis
 
-Display the details of a bug
+Display the details of a bug.
 
 ```
 git-bug show [<id>] [flags]
@@ -19,5 +19,5 @@ git-bug show [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 5a1c1f4a55b207fd92dbfa60c668fd2ada564763..a04098e6e6e4ec1d3f96cc251c21d58399f3ab84 100644
--- a/doc/md/git-bug_status.md
+++ b/doc/md/git-bug_status.md
@@ -1,10 +1,10 @@
 ## git-bug status
 
-Display or change a bug status
+Display or change a bug status.
 
 ### Synopsis
 
-Display or change a 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 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
+* [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 e0655338c49028d2daca8f6373a61c6524513745..4978341fde32bc57c32fb62093fe43ad2c4785b5 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 a bug as closed
+Mark a bug as closed.
 
 ### Synopsis
 
-Mark a 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)	 - Display or change a 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 3763d4cd15f25e3143117d53a3217d50fe0be3f2..f6d03215a389e9f3f6e0928c076e381ded98859b 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 a bug as open
+Mark a bug as open.
 
 ### Synopsis
 
-Mark a 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)	 - Display or change a 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 53ed49e5fab57e1405770e561f68b77bdc3fd874..02e59e60e626490ce0d267d46467442846e06ada 100644
--- a/doc/md/git-bug_termui.md
+++ b/doc/md/git-bug_termui.md
@@ -1,10 +1,10 @@
 ## git-bug termui
 
-Launch the terminal UI
+Launch the terminal UI.
 
 ### Synopsis
 
-Launch the terminal UI
+Launch the terminal UI.
 
 ```
 git-bug termui [flags]
@@ -18,5 +18,5 @@ git-bug termui [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker 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 85a5d9f793bec095f13afc215765fa18efbd5ce0..2e51b06f9a29000cefb0daecc0a34dc8e8edbd18 100644
--- a/doc/md/git-bug_title.md
+++ b/doc/md/git-bug_title.md
@@ -1,10 +1,10 @@
 ## git-bug title
 
-Display or change a title
+Display or change a title.
 
 ### Synopsis
 
-Display or change a 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 bug tracker embedded in Git
-* [git-bug title edit](git-bug_title_edit.md)	 - Edit a 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 dc4633902221744eb815e306dd0871058aaf2784..63c7168b798c02549282d0a17ba5920c5a488ffb 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 title
+Edit a title.
 
 ### Synopsis
 
-Edit a 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 or change a title
+* [git-bug title](git-bug_title.md)	 - Display or change a title.
 
diff --git a/doc/md/git-bug_user.md b/doc/md/git-bug_user.md
index f6a3d91bad0be1b98c90760d9565f652771974db..8121b750f401e96414c3383bae65d7ee6542815c 100644
--- a/doc/md/git-bug_user.md
+++ b/doc/md/git-bug_user.md
@@ -1,10 +1,10 @@
 ## git-bug user
 
-Display or change the user identity
+Display or change the user identity.
 
 ### Synopsis
 
-Display or change the user identity
+Display or change the user identity.
 
 ```
 git-bug user [<id>] [flags]
@@ -18,7 +18,8 @@ git-bug user [<id>] [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
-* [git-bug user create](git-bug_user_create.md)	 - Create a new identity
-* [git-bug user ls](git-bug_user_ls.md)	 - List identities
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
+* [git-bug user adopt](git-bug_user_adopt.md)	 - Adopt an existing identity as your own.
+* [git-bug user create](git-bug_user_create.md)	 - Create a new identity.
+* [git-bug user ls](git-bug_user_ls.md)	 - List identities.
 
diff --git a/doc/md/git-bug_user_create.md b/doc/md/git-bug_user_create.md
index 55a1159cab1d390280081e7ac58bbfc8abd0cf88..8af6e37a16b11ff8f34635217f8a84820787b347 100644
--- a/doc/md/git-bug_user_create.md
+++ b/doc/md/git-bug_user_create.md
@@ -1,10 +1,10 @@
 ## git-bug user create
 
-Create a new identity
+Create a new identity.
 
 ### Synopsis
 
-Create a new identity
+Create a new identity.
 
 ```
 git-bug user create [flags]
@@ -18,5 +18,5 @@ git-bug user create [flags]
 
 ### SEE ALSO
 
-* [git-bug user](git-bug_user.md)	 - Display or change the user identity
+* [git-bug user](git-bug_user.md)	 - Display or change the user identity.
 
diff --git a/doc/md/git-bug_user_ls.md b/doc/md/git-bug_user_ls.md
index 9c9651f5b6c0c0e176eb0ffa016f264b607dbd75..9f70674591ca97465ba4c93a1ffb59e98dad4756 100644
--- a/doc/md/git-bug_user_ls.md
+++ b/doc/md/git-bug_user_ls.md
@@ -1,10 +1,10 @@
 ## git-bug user ls
 
-List identities
+List identities.
 
 ### Synopsis
 
-List identities
+List identities.
 
 ```
 git-bug user ls [flags]
@@ -19,5 +19,5 @@ git-bug user ls [flags]
 
 ### SEE ALSO
 
-* [git-bug user](git-bug_user.md)	 - Display or change the user identity
+* [git-bug user](git-bug_user.md)	 - Display or change the user identity.
 
diff --git a/doc/md/git-bug_version.md b/doc/md/git-bug_version.md
index 6b6d428834712caee63edc62f9313e6dcd19ad25..d10312ffd562253bda4ad25f61a892f6eda95e42 100644
--- a/doc/md/git-bug_version.md
+++ b/doc/md/git-bug_version.md
@@ -1,10 +1,10 @@
 ## git-bug version
 
-Show git-bug version information
+Show git-bug version information.
 
 ### Synopsis
 
-Show git-bug version information
+Show git-bug version information.
 
 ```
 git-bug version [flags]
@@ -21,5 +21,5 @@ git-bug version [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
 
diff --git a/doc/md/git-bug_webui.md b/doc/md/git-bug_webui.md
index 670130aab96796ce9003d6fdc30b564175500728..cc3a85de121369a94f06917c79499ea461aa2097 100644
--- a/doc/md/git-bug_webui.md
+++ b/doc/md/git-bug_webui.md
@@ -1,10 +1,10 @@
 ## git-bug webui
 
-Launch the web UI
+Launch the web UI.
 
 ### Synopsis
 
-Launch the web UI
+Launch the web UI.
 
 ```
 git-bug webui [flags]
@@ -19,5 +19,5 @@ git-bug webui [flags]
 
 ### SEE ALSO
 
-* [git-bug](git-bug.md)	 - A bug tracker embedded in Git
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.