deployer/.github/workflows/docs.yml

name: doc

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

jobs:
  docgen:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2

    - name: Validate composer.json and composer.lock
      run: composer validate

    - name: Cache Composer packages
      id: composer-cache
      uses: actions/cache@v2
      with:
        path: vendor
        key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
        restore-keys: |
          ${{ runner.os }}-php-

    - name: Install dependencies
      if: steps.composer-cache.outputs.cache-hit != 'true'
      run: composer install --prefer-dist --no-progress

    - name: Run docgen
      run: php bin/docgen

    - name: Check for uncommitted changes
      run: |
        status=$(git status --porcelain docs/);
        [ -z "$status" ] || {
          echo "Please, run bin/docgen and commit next files:";
          echo $status;
          exit 1;
        }