Invalid workflow file: docs.yml uses unrecognized hashFiles function

[trsdn]

Problem Description

The docs.yml workflow has an invalid syntax error that prevents it from running:

Invalid workflow file: .github/workflows/docs.yml#L1
(Line: 66, Col: 9): Unrecognized function: 'hashFiles'. Located at position 1 within expression: hashFiles('docs/conf.py') != ''

Root Cause

The workflow is trying to use the hashFiles function in a conditional expression, but the syntax is incorrect.

Current Code (Line 66)

if: hashFiles('docs/conf.py') != ''

Proposed Solution

The hashFiles function should be used with proper GitHub Actions expression syntax:

Option 1: Use proper expression syntax

if: ${{ hashFiles('docs/conf.py') != '' }}

Option 2: Check for file existence differently

- name: Check if docs exist
  id: check_docs
  run: |
    if [ -f docs/conf.py ]; then
      echo "docs_exist=true" >> $GITHUB_OUTPUT
    else
      echo "docs_exist=false" >> $GITHUB_OUTPUT
    fi

- name: Build documentation
  if: steps.check_docs.outputs.docs_exist == 'true'
  # ... rest of the step

Option 3: Use paths filter (if checking for changes)

on:
  push:
    paths:
      - 'docs/**'
      - '*.md'

Impact

• Documentation builds are failing for all PRs
• CI Gates may fail due to this workflow error
• Documentation is not being validated

Test Case

Found in PR #16 where the workflow fails immediately with this syntax error.

Priority

High - This breaks documentation builds for all PRs and may affect release documentation.

Files Affected

• .github/workflows/docs.yml (line 66)

[trsdn]

Additional Issue: Misleading Workflow Name

The workflow file is named docs.yml but based on the content (checking for docs/conf.py), it appears to be the Documentation Build workflow. However, the workflow name at the top of the file should be more descriptive.

Current Issue

• Workflow file: .github/workflows/docs.yml
• Workflow name: Not clearly defined or incorrectly named
• Purpose: Appears to be for building/validating documentation

Recommendation

The workflow should have a clear, descriptive name like:

name: Documentation Build and Validation

on:
  pull_request:
    paths:
      - 'docs/**'
      - '*.md'
  push:
    branches: [main]
    paths:  
      - 'docs/**'
      - '*.md'

This makes it clear in the GitHub Actions UI what this workflow does.