name: Generate Documentation
on:
    push:
        tags:
            - "*"
    workflow_dispatch:
        inputs:
            tag:
                description: 'Tag to generate documentation for'
                required: false
    pull_request:

permissions:
  contents: write

jobs:
    docs:
        name: "Generate and Deploy Documentation"
        uses: GoogleCloudPlatform/php-tools/.github/workflows/doctum.yml@main
        with:
          title: "Google Cloud PHP Client"
          default_version: ${{ inputs.tag || github.head_ref || github.ref_name }}
          exclude_file: aliases.php
          tag_pattern: "v2.*"
          dry_run: ${{ github.event_name == 'pull_request' }}