check-docs.yml

# Copyright 2023 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

name: Doc Change Check (Run "yarn docgen:all" if this fails)

on: pull_request

jobs:
  doc-check:
    name: Check if reference docs have changed
    runs-on: ubuntu-latest

    steps:
    - name: Checkout Repo
      uses: actions/checkout@master
      with:
        # get all history for the diff
        fetch-depth: 0
    - name: Set up Node (20)
      uses: actions/setup-node@v3
      with:
        node-version: 20.x
    - name: Yarn install
      run: yarn
    - name: Run doc generation
      run: yarn docgen:all
    - name: Check for changes in docs-devsite dir (fail if so)
      run: git diff --exit-code docs-devsite
    - name: Reference documentation needs to be updated. See message below.
      if: ${{ failure() }}
      run: echo "Changes in this PR affect the reference docs. Run \`yarn docgen:all\` locally to regenerate docs and add them to this PR."