diff --git a/doc/hooks b/doc/hooks
index c547e4763f7b60ccb16d4ed00039bd82addab179..81f5df2902520e43c4c9a9e0ba5d39cd4f813ff9 100644
--- a/doc/hooks
+++ b/doc/hooks
@@ -5,7 +5,11 @@ Available hooks are:
 * pre-hook
 * post-clone
 * post-clone-retired
-	use this if you need to operate on different git repositories after cloning
+	Use this if you need to operate on different git repositories after cloning.
+	This hook can be useful if your configuration needs some remote
+	repositories, but you do not want to include it into your vcsh
+	repository. For instance, if you use vim plugins manager (vundle,
+	NeoBundle), zsh configuration frameworks (oh-my-zsh, prezto), etc.
 * pre-enter
 * post-enter
 * pre-run