Link and Spell checker Gihub Actions

.github/workflows/check-links-and-spelling.yml

@@ -0,0 +1,91 @@
+###############################################################################
+# Introduction:
+# -------------
+# This workflow builds the NMDC documentation, checks for broken links,
+# and identifies any spelling errors in the documentation.
+# If any issues are found (broken links or misspelled words), it creates
+# GitHub Issues containing lists of the errors for further review and fixing.
+#
+###############################################################################
+
+name: Check Links and Spelling in Documentation
+
+on:
+  push: { branches: [ main ] }
+  workflow_dispatch: { }
+  workflow_call: { }
+  # pull_request: 
+  #   branches: [main]
+
+jobs:
+  check-links:
+    name: Check Links in Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out commit
+        uses: actions/checkout@v4
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - name: Run Markdown Link Check
+        id: linkcheck
+        # Source: https://github.com/tcort/markdown-link-check
+        continue-on-error: true
+        run: |
+          mkdir -p linkcheck_reports
+          npx markdown-link-check \
+            --quiet \
+            --verbose \
+            artifacts/**/*.html |
+           tee linkcheck_reports/linkcheck_output.txt
+          if grep -q 'Error' linkcheck_reports/linkcheck_output.txt; then
+            echo "links_broken=true" >> $GITHUB_OUTPUT
+          else
+            echo "links_broken=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create GitHub Issue for Broken Links
+        if: ${{ steps.linkcheck.outputs.links_broken == 'true' }}
+        uses: peter-evans/create-issue-from-file@v4
+        with:
+          title: Broken links detected in documentation
+          content-filepath: linkcheck_reports/linkcheck_output.txt
+          labels: documentation, broken-link
+
+  check-spelling:
+    name: Check Spelling in Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out commit
+        uses: actions/checkout@v4
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - name: Run Spell Checker
+        id: spellcheck
+        continue-on-error: true
+        # Source: https://github.com/tbroadley/spellchecker-cli and https://github.com/austenstone/spellchecker-cli-action-summary
+        # Based off: https://github.com/austenstone/spellchecker-cli-action-summary/blob/main/.github/workflows/spellcheck.yml
+        run: |
+          mkdir -p spellcheck_reports
+          npx -y spellchecker-cli \
+            --files artifacts/**/*.html \
+            --dictionaries .github/workflows/spellcheck_allow_list.txt \
+            --plugins spell indefinite-article repeated-words syntax-mentions syntax-urls \
+            --reports spellcheck_reports/spellcheck_report.json |
+            tee spellcheck_reports/spellcheck_output.txt
+          if grep -q 'misspelt' spellcheck_reports/spellcheck_report.json; then
+            echo "misspelt=true" >> $GITHUB_OUTPUT
+          else
+            echo "misspelt=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create GitHub Issue for Misspellings
+        if: ${{ steps.spellcheck.outputs.misspelt == 'true' }}
+        uses: peter-evans/create-issue-from-file@v4
+        with:
+          title: Documentation contains misspelled words
+          content-filepath: spellcheck_reports/spellcheck_output.txt
+          labels: documentation, spelling-error

.github/workflows/deploy-to-gh-pages.yml

@@ -62,20 +62,26 @@ jobs:
         with:
           path: _build/html
 
-  deploy:
-    name: Deploy website
-    needs:
-      - build
-    runs-on: ubuntu-latest
-    # Reference: https://github.com/actions/deploy-pages
-    permissions:
-      pages: write
-      id-token: write
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      # Reference: https://github.com/actions/deploy-pages
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
+  check-links-and-spelling:
+    name: Check Links and Spelling in Documentation
+    uses: ./.github/workflows/check-links-and-spelling.yml
+    needs: build
+
+
+  # deploy:
+  #   name: Deploy website
+  #   needs:
+  #     - build
+  #   runs-on: ubuntu-latest
+  #   # Reference: https://github.com/actions/deploy-pages
+  #   permissions:
+  #     pages: write
+  #     id-token: write
+  #   environment:
+  #     name: github-pages
+  #     url: ${{ steps.deployment.outputs.page_url }}
+  #   steps:
+  #     # Reference: https://github.com/actions/deploy-pages
+  #     - name: Deploy to GitHub Pages
+  #       id: deployment
+  #       uses: actions/deploy-pages@v4

.github/workflows/mlc_config.json

@@ -0,0 +1,7 @@
+{
+    "timeout": "20s",
+    "retryOn429": true,
+    "retryCount": 5,
+    "fallbackRetryDelay": "30s",
+    "aliveStatusCodes": [200, 206]
+  }

.github/workflows/spellcheck_allow_list.txt

@@ -0,0 +1,36 @@
+Bioinformatics
+bioinformatics
+Biosample
+biosample
+Changesheets
+changesheets
+Community-centric
+community-centric
+Diátaxis
+Globus
+IMG
+JSON
+json
+Lipidomics
+lipidomics
+Metabolomics
+metabolomics
+MetaG
+Metagenome
+metagenome
+Metagenomic
+metagenomic
+Metaproteomic
+MetaT
+Metatranscriptome
+metatranscriptome
+Metatranscriptomic
+metatranscriptomic
+Microbiome
+microbiome
+Mgt
+MkDocs
+multi-omics
+NMDC
+NMDC's
+nmdc-runtime