documentation-linux-ci.yml

name: Documentation Linux CI

concurrency: 
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
  
on:
  push:
    branches: [ master ]
    paths:
    - 'documentation/**'
  pull_request:
    branches: [ master ]
    paths:
    - 'documentation/**'
    - '.github/workflows/**'
  workflow_dispatch:
    

jobs:
  build:
    if: ${{ github.event_name == 'pull_request' }}

    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [18.x, 20.x]

    steps:
    - uses: actions/checkout@v4

    - name: Build ${{ matrix.node-version }}
      uses: actions/setup-node@v4
      with:
        node-version: ${{ matrix.node-version }}

    - name: Cache node modules docs
      uses: actions/cache@v4
      with:
        # npm cache files are stored in `~/.npm` on Linux/macOS
        path: ~/.npm
        key: ${{ runner.os }}-documentation-${{ hashFiles('./documentation/package-lock.json') }}
        restore-keys: |
          ${{ runner.os }}-documentation-

    - name: Install Dependencies
      working-directory: ./documentation
      run: npm ci --no-progress --prefer-offline --legacy-peer-deps --no-fund
      
    - name: NpmBuild
      working-directory: ./documentation
      run: npm run build


  release:
    if: ${{ github.event_name != 'pull_request' && github.repository == 'qdraw/starsky' && github.ref == 'refs/heads/master' }}

    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: '18.x'

      - name: Cache node modules docs
        uses: actions/cache@v4
        with:
          # npm cache files are stored in `~/.npm` on Linux/macOS
          path: ~/.npm
          key: ${{ runner.os }}-documentation-${{ hashFiles('./documentation/package-lock.json') }}
          restore-keys: |
            ${{ runner.os }}-documentation-

      - name: Install Dependencies
        working-directory: ./documentation
        run: npm ci --no-progress --prefer-offline --legacy-peer-deps --no-fund
        
      - name: NpmBuild
        working-directory: ./documentation
        run: npm run build