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' }}