4 files changed, 52 insertions, 4 deletions
diff --git a/doc/md/git-bug.md b/doc/md/git-bug.md
index 6131ed2c..b3f66627 100644
--- a/doc/md/git-bug.md
+++ b/doc/md/git-bug.md
@@ -20,12 +20,12 @@ git-bug [flags]
 
 ### SEE ALSO
 
+* [git-bug add](git-bug_add.md)	 - Create a new bug
 * [git-bug close](git-bug_close.md)	 - Mark the bug as closed
 * [git-bug commands](git-bug_commands.md)	 - Display available commands
-* [git-bug comment](git-bug_comment.md)	 - Add a new comment to a bug
+* [git-bug comment](git-bug_comment.md)	 - Show a bug's comments
 * [git-bug label](git-bug_label.md)	 - Manipulate bug's label
 * [git-bug ls](git-bug_ls.md)	 - List bugs
-* [git-bug new](git-bug_new.md)	 - Create a new bug
 * [git-bug open](git-bug_open.md)	 - Mark the bug as open
 * [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
diff --git a/doc/md/git-bug_add.md b/doc/md/git-bug_add.md
new file mode 100644
index 00000000..21060f61
--- /dev/null
+++ b/doc/md/git-bug_add.md
@@ -0,0 +1,25 @@
+## git-bug add
+
+Create a new bug
+
+### Synopsis
+
+Create a new bug
+
+```
+git-bug add [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 add
+```
+
+### SEE ALSO
+
+* [git-bug](git-bug.md)	 - A bugtracker embedded in Git
+
diff --git a/doc/md/git-bug_comment.md b/doc/md/git-bug_comment.md
index 8616c511..9870e5fe 100644
--- a/doc/md/git-bug_comment.md
+++ b/doc/md/git-bug_comment.md
@@ -1,10 +1,10 @@
 ## git-bug comment
 
-Add a new comment to a bug
+Show a bug's comments
 
 ### Synopsis
 
-Add a new comment to a bug
+Show a bug's comments
 
 ```
 git-bug comment <id> [flags]
@@ -21,4 +21,5 @@ 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
 
diff --git a/doc/md/git-bug_comment_add.md b/doc/md/git-bug_comment_add.md
new file mode 100644
index 00000000..412e40d7
--- /dev/null
+++ b/doc/md/git-bug_comment_add.md
@@ -0,0 +1,22 @@
+## git-bug comment add
+
+Add a new comment to a bug
+
+### Synopsis
+
+Add a new comment to a bug
+
+```
+git-bug comment add <id> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for add
+```
+
+### SEE ALSO
+
+* [git-bug comment](git-bug_comment.md)	 - Show a bug's comments
+