diff --git a/doc/branches.mdwn b/doc/branches.mdwn
index bc3bdc668..f33641290 100644
--- a/doc/branches.mdwn
+++ b/doc/branches.mdwn
@@ -1,6 +1,8 @@
 In order to refer to a branch in one of the [[git]] repositories, for
 example when submitting a [[patch]], you can use the
-[[templates/gitbranch]] template.
+[[templates/gitbranch]] template. For example:
+
+	\[[!template id=gitbranch branch=yourrepo/amazingbranch author="[[yourname]]"]]
 
 Branches referred to in open [[bugs]] and [[todo]]: