summaryrefslogtreecommitdiff
path: root/plugins/git-hubflow
diff options
context:
space:
mode:
authorMarco Zühlke <mzuehlke@gmail.com>2018-10-28 13:46:08 +0100
committerMarc Cornellà <marc.cornella@live.com>2018-10-28 13:46:08 +0100
commitf1250cfbce4dc08b1b4d147ff533fad0ca64d5e0 (patch)
tree4fce4b2afcaaa8a060e416a0d97757a1643a4e36 /plugins/git-hubflow
parent9db3c9455377e15b8125e68a550e751bc5a3203f (diff)
downloadzsh-f1250cfbce4dc08b1b4d147ff533fad0ca64d5e0.tar.gz
zsh-f1250cfbce4dc08b1b4d147ff533fad0ca64d5e0.tar.bz2
zsh-f1250cfbce4dc08b1b4d147ff533fad0ca64d5e0.zip
git-hubflow: add README (#7361)
Diffstat (limited to 'plugins/git-hubflow')
-rw-r--r--plugins/git-hubflow/README.md24
-rw-r--r--plugins/git-hubflow/git-hubflow.plugin.zsh22
2 files changed, 24 insertions, 22 deletions
diff --git a/plugins/git-hubflow/README.md b/plugins/git-hubflow/README.md
new file mode 100644
index 000000000..dada60d78
--- /dev/null
+++ b/plugins/git-hubflow/README.md
@@ -0,0 +1,24 @@
+# git-hubflow plugin
+
+This plugin adds completion for [HubFlow](https://datasift.github.io/gitflow/) (GitFlow for GitHub), as well as some
+aliases for common commands. HubFlow is a git extension to make it easy to use GitFlow with GitHub. Based on the
+original gitflow extension for git.
+
+The hubflow tool has to be [installed](https://github.com/datasift/gitflow#installation) separately.
+
+To use it, add `git-hubflow` to the plugins array in your zshrc file:
+
+```zsh
+plugins=(... git-hubflow)
+```
+
+## Aliases
+
+| Alias | Command | Description |
+|-------|------------------|------------------------------------------------------------------|
+| ghf | `git hf` | Print command overview |
+| ghff | `git hf feature` | Manage your feature branches |
+| ghfr | `git hf release` | Manage your release branches |
+| ghfh | `git hf hotfix` | Manage your hotfix branches |
+| ghfs | `git hf support` | Manage your support branches |
+| ghfu | `git hf update` | Pull upstream changes down into your master and develop branches |
diff --git a/plugins/git-hubflow/git-hubflow.plugin.zsh b/plugins/git-hubflow/git-hubflow.plugin.zsh
index 8d968229f..05479f7e6 100644
--- a/plugins/git-hubflow/git-hubflow.plugin.zsh
+++ b/plugins/git-hubflow/git-hubflow.plugin.zsh
@@ -1,25 +1,3 @@
-#!zsh
-#
-# Installation
-# ------------
-#
-# To achieve git-hubflow completion nirvana:
-#
-# 0. Update your zsh's git-completion module to the newest version.
-# From here: https://github.com/zsh-users/zsh/blob/master/Completion/Unix/Command/_git
-#
-# 1. Install this file. Either:
-#
-# a. Place it in your .zshrc:
-#
-# b. Or, copy it somewhere (e.g. ~/.git-hubflow-completion.zsh) and put the following line in
-# your .zshrc:
-#
-# source ~/.git-hubflow-completion.zsh
-#
-# c. Or, use this file as an oh-my-zsh plugin.
-#
-
alias ghf='git hf'
alias ghff='git hf feature'
alias ghfr='git hf release'