Define dev->feature->main PR workflows

Author: TSampley

.github/workflows/docs-pr-checks.yml

@@ -0,0 +1,37 @@
+name: "PR Checks for `main` documentation"
+on:
+  pull_request:
+    types:
+      - opened        # initially opened
+      - reopened      # closed then opened again
+      - synchronize   # any changes pushed
+    branches:
+      - main
+    paths: # Only run checks on changes to documentation
+      - "**/docs/*"
+      - "*/README.md"
+
+jobs:
+  setup:
+    name: "Setup Environment"
+    runs-on: [ubuntu-22.04]
+    if: github.event.pull_request.draft == false # ignore draft pull requests
+#    env:
+#
+#    outputs:
+#
+    steps:
+      - name: "Checkout Project"
+        uses: actions/checkout@v4
+      - name: "Setup Java 17"
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin' # See 'Supported distributions' for available options
+          java-version: '17'
+      - name: "Setup Gradle"
+        uses: gradle/actions/setup-gradle@v3
+
+      - name: "Generate Documentation"
+        run: ./gradlew dokka
+
+#      - run: upload documentation to GitHub pages site

.github/workflows/feature-pr-checks.yml

@@ -0,0 +1,37 @@
+name: "PR Checks for feature branches"
+on:
+  pull_request:
+    types:
+      - opened        # initially opened
+      - reopened      # closed then opened again
+      - synchronize   # any changes pushed
+    branches:
+      - "feature/*"
+    paths-ignore: # Only run checks on changes to code
+      - "**/docs/*"
+      - "*/README.md"
+
+jobs:
+  build:
+    name: "Setup Environment"
+    runs-on: [ubuntu-22.04]
+    if: github.event.pull_request.draft == false # ignore draft pull requests
+#    env:
+#
+#    outputs:
+#
+    steps:
+      - name: "Checkout Project"
+        uses: actions/checkout@v4
+      - name: "Setup Java 17"
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin' # See 'Supported distributions' for available options
+          java-version: '17'
+      - name: "Setup Gradle"
+        uses: gradle/actions/setup-gradle@v3
+
+      - name: "Build: Assemble and Test entire project"
+        run: ./gradlew build
+
+#      - run: ./gradlew generate coverage report, upload test/coverage reports

.github/workflows/main-pr-checks.yml

@@ -0,0 +1,36 @@
+name: "PR Checks for `main`"
+on:
+  pull_request:
+    types:
+      - opened        # initially opened
+      - reopened      # closed then opened again
+      - synchronize   # any changes pushed
+    branches:
+      - main
+    paths-ignore: # Only run checks on changes to code
+      - "**/docs/*"
+      - "*/README.md"
+
+jobs:
+  setup:
+    name: "Setup Environment"
+    runs-on: [ubuntu-22.04]
+#    env:
+#
+#    outputs:
+#
+    steps:
+      - name: "Checkout Project"
+        uses: actions/checkout@v4
+      - name: "Setup Java 17"
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin' # See 'Supported distributions' for available options
+          java-version: '17'
+      - name: "Setup Gradle"
+        uses: gradle/actions/setup-gradle@v3
+
+      - name: "Build: Assemble and Test entire project"
+        run: ./gradlew build
+
+#      - run: ./gradlew generate coverage report, upload test/coverage reports