Merge pull request #89 from MichaelMure/identity

WIP identity in git

36 files changed, 217 insertions, 194 deletions

diff --git a/doc/md/git-bug.md b/doc/md/git-bug.md
index a1c1c885..1de9133b 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,22 +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 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 d212c9b1..c103cebb 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 da7f0978..7d01a300 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_bridge.md b/doc/md/git-bug_bridge_bridge.md
deleted file mode 100644
index d5803190..00000000
--- a/doc/md/git-bug_bridge_bridge.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## git-bug bridge bridge
-
-Configure and use bridges to other bug trackers
-
-### Synopsis
-
-Configure and use bridges to other bug trackers
-
-```
-git-bug bridge bridge [flags]
-```
-
-### Options
-
-```
-  -h, --help   help for bridge
-```
-
-### SEE ALSO
-
-* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers
-
diff --git a/doc/md/git-bug_bridge_configure.md b/doc/md/git-bug_bridge_configure.md
index ca66f500..63fbbbca 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 10da2e8a..14b62f60 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 15b20749..ab58e969 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_close.md b/doc/md/git-bug_close.md
deleted file mode 100644
index ab95706d..00000000
--- a/doc/md/git-bug_close.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## git-bug close
-
-Mark the bug as closed
-
-### Synopsis
-
-Mark the bug as closed
-
-```
-git-bug close <id> [flags]
-```
-
-### Options
-
-```
-  -h, --help   help for close
-```
-
-### SEE ALSO
-
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-
diff --git a/doc/md/git-bug_commands.md b/doc/md/git-bug_commands.md
index 6d777b40..e1a409d2 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 0ffd9e96..31a80e51 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 7b8e5043..5a1e429e 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 dbc86dc9..7cf667b0 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 9c214fe9..df2cae5a 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 f37cc080..9e642734 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 19e664f8..850b4d58 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 00000000..2e99f134
--- /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 f3b82f4f..9ee6fa8c 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 a9a2994a..18ac5d61 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_new.md b/doc/md/git-bug_new.md
deleted file mode 100644
index de6cffbf..00000000
--- a/doc/md/git-bug_new.md
+++ /dev/null
@@ -1,25 +0,0 @@
-## git-bug new
-
-Create a new bug
-
-### Synopsis
-
-Create a new bug
-
-```
-git-bug new [flags]
-```
-
-### Options
-
-```
-  -t, --title string     Provide a title to describe the issue
-  -m, --message string   Provide a message to describe the issue
-  -F, --file string      Take the message from the given file. Use - to read the message from the standard input
-  -h, --help             help for new
-```
-
-### SEE ALSO
-
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-
diff --git a/doc/md/git-bug_open.md b/doc/md/git-bug_open.md
deleted file mode 100644
index 38c6d6fa..00000000
--- a/doc/md/git-bug_open.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## git-bug open
-
-Mark the bug as open
-
-### Synopsis
-
-Mark the bug as open
-
-```
-git-bug open <id> [flags]
-```
-
-### Options
-
-```
-  -h, --help   help for open
-```
-
-### SEE ALSO
-
-* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
-
diff --git a/doc/md/git-bug_pull.md b/doc/md/git-bug_pull.md
index dad75b8b..1519c87f 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 1ea996ed..5e95ea2f 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 6831496d..c8125380 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 677ce9cd..86f3cfce 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 5a1c1f4a..a04098e6 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 e0655338..4978341f 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 3763d4cd..f6d03215 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 53ed49e5..02e59e60 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 85a5d9f7..2e51b06f 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 dc463390..63c7168b 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
new file mode 100644
index 00000000..8121b750
--- /dev/null
+++ b/doc/md/git-bug_user.md
@@ -0,0 +1,25 @@
+## git-bug user
+
+Display or change the user identity.
+
+### Synopsis
+
+Display or change the user identity.
+
+```
+git-bug user [<id>] [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for user
+```
+
+### SEE ALSO
+
+* [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_adopt.md b/doc/md/git-bug_user_adopt.md
new file mode 100644
index 00000000..f89cdf68
--- /dev/null
+++ b/doc/md/git-bug_user_adopt.md
@@ -0,0 +1,22 @@
+## git-bug user adopt
+
+Adopt an existing identity as your own.
+
+### Synopsis
+
+Adopt an existing identity as your own.
+
+```
+git-bug user adopt <id> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for adopt
+```
+
+### SEE ALSO
+
+* [git-bug user](git-bug_user.md)	 - Display or change the user identity.
+
diff --git a/doc/md/git-bug_user_create.md b/doc/md/git-bug_user_create.md
new file mode 100644
index 00000000..8af6e37a
--- /dev/null
+++ b/doc/md/git-bug_user_create.md
@@ -0,0 +1,22 @@
+## git-bug user create
+
+Create a new identity.
+
+### Synopsis
+
+Create a new identity.
+
+```
+git-bug user create [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for create
+```
+
+### SEE ALSO
+
+* [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
new file mode 100644
index 00000000..d390ed2a
--- /dev/null
+++ b/doc/md/git-bug_user_ls.md
@@ -0,0 +1,22 @@
+## git-bug user ls
+
+List identities.
+
+### Synopsis
+
+List identities.
+
+```
+git-bug user ls [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for ls
+```
+
+### SEE ALSO
+
+* [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 6b6d4288..d10312ff 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 670130aa..cc3a85de 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.