apiVersion: naftiko.io/v1
kind: Capability
metadata:
  id: branch-based-documentation
  name: Branch Based Documentation
  provider: bump-sh
  description: >-
    Maintain parallel branches of API documentation that mirror source-control
    branches, promote a branch to default once merged, and clean up retired
    branches.
spec:
  inputs:
    - name: documentation
      description: Documentation slug.
    - name: branchName
      description: Branch to create or promote.
  steps:
    - id: list-branches
      uses: bump-sh-api.listBranches
      with:
        doc_id_or_slug: ${{ inputs.documentation }}
    - id: create-branch
      uses: bump-sh-api.createBranch
      with:
        doc_id_or_slug: ${{ inputs.documentation }}
        name: ${{ inputs.branchName }}
    - id: promote-branch
      uses: bump-sh-api.setDefaultBranch
      with:
        doc_id_or_slug: ${{ inputs.documentation }}
        slug: ${{ inputs.branchName }}
      condition: ${{ inputs.promote == true }}
  outputs:
    branchUrl: ${{ steps.create-branch.outputs.url }}