Setting `branch` only should suffice for checking out a specific branch

[pat-s]

I'd expect the following to suffice for checking out a dedicated branch which differs from the $CI_COMMIT_BRANCH the pipeline trigger originated from:

clone:
  git:
    image: woodpeckerci/plugin-git:2.6.5
    settings:
      branch: gh-pages

However, this still results in a checkout of $CI_COMMIT_BRANCH. Instead, the following is needed:

clone:
  git:
    image: woodpeckerci/plugin-git:2.6.5
    settings:
      branch: gh-pages
      ref: gh-pages

Note the ref: gh-pages part.

I think this is a bug and ref shouldn't have an actual part in this. Any opinions?

[anbraten]

I would agree in case a specific branch is provided it should be used. If both are present I am fine with ref having the higher precedence or even throwing an error saying you should provide either a ref or branch.