Auto-publish code docs on github (#1722)

Co-authored-by: Bess Sadler <bess@users.noreply.github.com>
Co-authored-by: Robert-Anthony Lee-Faison <leefaisonr@users.noreply.github.com>
Co-authored-by: Bess Sadler <bess.sadler@princeton.edu>

.github/workflows/pages.yml

@@ -0,0 +1,40 @@
+---
+name: Deploy API docs to GitHub Pages
+on:
+  push:
+    branches: ['main']
+    # paths:
+    #   - '.github/workflows/pages.yml'
+    #   - '.yardopts'
+    #   - 'lib/**'
+    #   - 'Gemfile'
+    #   - '**.txt'
+    # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: 'pages'
+  cancel-in-progress: true
+
+jobs:
+  deploy_yard:
+    # the deploy environment (not to be confused with env)
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    name: Build and deploy YARD
+    steps:
+      - uses: kachick/deploy-yard-to-pages@v1.3.0
+        id: deployment
+        with:
+          # default `doc` as default of `.yardopts`
+          # output-dir: 'doc'
+          # default version is 3.2
+          ruby-version: '3.2'

.gitignore

@@ -55,3 +55,4 @@ node_modules
 # https://vitejs.dev/guide/env-and-mode.html#env-files
 *.local
 test_results/**
+.yardoc/

Gemfile

@@ -71,6 +71,7 @@ group :development, :test do
   gem "equivalent-xml", "~> 0.6.0"
   gem "pry-byebug"
   gem "pry-rails"
+  gem "yard"
 end
 
 group :development do

Gemfile.lock

@@ -540,6 +540,7 @@ GEM
       xml-mapping (~> 0.10)
     xpath (3.2.0)
       nokogiri (~> 1.8)
+    yard (0.9.36)
     zeitwerk (2.6.13)
 
 PLATFORMS
@@ -615,6 +616,7 @@ DEPENDENCIES
   web-console (>= 4.1.0)
   webmock
   whenever
+  yard
 
 BUNDLED WITH
    2.4.20