clarify usage of branch, tag and ref keys

Fixes #713