branch: improve documentation and naming of create_branch() parameters