Introduce CI workflow logic

.github/workflows/build_docs.yml

@@ -1,14 +1,19 @@
-# workflow to build and deploy FORD docs for FTorch
-
+# Workflow to build and deploy FORD docs for FTorch
 name: BuildDocs
 
 # Controls when the workflow will run
 on:
-  # Triggers the workflow on push or pull request events but only for the "main" branch
+  # Triggers the workflow on pushes to the "main" branch, i.e., PR merges
   push:
     branches: [ "main"]
+
+  # Triggers the workflow on pushes to open pull requests to main with documentation changes
   pull_request:
     branches: [ "main" ]
+    paths:
+      - '.github/workflows/build_docs.yml'
+      - '**.md'
+      - 'pages/*'
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:

.github/workflows/fypp.yml → .github/workflows/fypp_checks.yml

@@ -1,19 +1,25 @@
-name: fypp-checks
+# Workflow to run Fortran pre-processor checks on source
+name: FyppChecks
 
 on:
-  # run on every push - doesn't work on forks
+  # Triggers the workflow on pushes to the "main" branch, i.e., PR merges
   push:
-  # run on every push (not commit) to a PR, plus open/reopen
-  pull_request:
-    types:
-    - synchronize
-    - opened
-    - reopened
+    branches: [ "main" ]
 
+  # Triggers the workflow on pushes to open pull requests with Fortran changes
+  pull_request:
+    paths:
+      - '.github/workflows/fypp_checks.yml'
+      - '**.fypp'
+      - '**.f90'
+      - '**.F90'
+      - '**.pf'
 
+# Workflow run - one or more jobs that can run sequentially or in parallel
 jobs:
-  various:
-    name: FYPP checks - runs check on fypp and f90 files
+  # This workflow contains a single job called "fypp-checks"
+  fypp-checks:
+    # The type of runner that the job will run on
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3

.github/workflows/linting.yml → .github/workflows/static_analysis.yml

@@ -1,13 +1,23 @@
-# workflow to run static-analysis and linting checks on source
-
+# Workflow to run static-analysis and linting checks on source
 name: StaticAnalysis
 
 # Controls when the workflow will run
 on:
-  # Triggers the workflow on pushes to the "main" branch and any pull request events
+  # Triggers the workflow on pushes to the "main" branch, i.e., PR merges
   push:
-    branches: [ "main"]
+    branches: [ "main" ]
+
+  # Triggers the workflow on pushes to open pull requests with code changes
   pull_request:
+    paths:
+      - '.github/workflows/static_analysis.yml'
+      - '**.c'
+      - '**.cpp'
+      - '**.fypp'
+      - '**.f90'
+      - '**.F90'
+      - '**.pf'
+      - '**.py'
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:

.github/workflows/test_suite.yml

@@ -1,17 +1,36 @@
-# workflow to run the FTorch test suite
-
+# Workflow to run the FTorch test suite
 name: TestSuite
 
 # Controls when the workflow will run
 on:
-  # Triggers the workflow on pushes to the "main" branch and any pull request events
+  # Triggers the workflow on pushes to the "main" branch, i.e., PR merges
   push:
-    branches: [ "main"]
+    branches: [ "main" ]
+
+  # Triggers the workflow on pushes to open pull requests with code changes
   pull_request:
+    paths:
+      - '.github/workflows/test_suite.yml'
+      - '**.c'
+      - '**.cpp'
+      - '**.fypp'
+      - '**.f90'
+      - '**.F90'
+      - '**.pf'
+      - '**.py'
+      - '**.sh'
+      - '**CMakeLists.txt'
+      - '**requirements.txt'
+      - '**data/*'
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
+# Cancel jobs running if new commits are pushed
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
 # Workflow run - one or more jobs that can run sequentially or in parallel
 jobs:
   # This workflow contains a single job called "test-suite"