clarify usage of branch, tag and ref keys
Merge pull request #719 from josephholsten/doc-ref-vs-branch

clarify usage of branch, tag and ref keys