fix broken links and add PR build workflow

.github/workflows/test-deploy.yml

@@ -0,0 +1,30 @@
+name: Test deployment
+
+on:
+  pull_request:
+    branches:
+      - main
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  test-deploy:
+    name: Test deployment
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build

docs/admin-guide/fix-caching-issues.md

@@ -6,7 +6,7 @@ it doesn't show up in the app.  The kinds of things cached are:
 * the org tree
 * org settings, e.g. `hemlock.events_calendar_url` or `credit.payments.allow`
 
-For details on how the caching is implemented, see [notes on caching](../notes-on-caching.md).
+For details on how the caching is implemented, see [notes on caching](notes-on-caching.md).
 
 ## How to bust the cache for you yourself right now
 

docs/admin-guide/notes-on-caching.md

@@ -0,0 +1,14 @@
+# Notes on Caching
+
+The Hemlock app adds 2 parameters to most HTTP GET requests:
+* `_ck=clientCacheKey`
+* `_sk=serverCacheKey`
+
+***clientCacheKey*** is the app versionCode.
+***serverCacheKey*** is the server ils-version appended with hemlock.cache_key.
+
+In this way we force cache misses in three situations:
+1. An app upgrade.
+2. A server upgrade.  Server upgrades sometimes involve incompatible IDL which would otherwise cause OSRF decode crashes.
+3. Evergreen admin action.  Changing `hemlock.cache_key` on orgID=1 is a final override that is needed only to push out org tree or org URL changes immediately.
+

docusaurus.config.ts

@@ -78,15 +78,6 @@ const config: Config = {
     footer: {
       style: 'dark',
       links: [
-        {
-          title: 'Docs',
-          items: [
-            {
-              label: 'Tutorial',
-              to: '/docs/intro',
-            },
-          ],
-        },
         {
           title: 'Related Repositories',
           items: [
@@ -104,15 +95,6 @@ const config: Config = {
             },
           ],
         },
-        {
-          title: 'More',
-          items: [
-            {
-              label: 'GitHub',
-              href: 'https://github.com/kenstir/hemlock-docs',
-            },
-          ],
-        },
       ],
       copyright: `Copyright © ${new Date().getFullYear()} Kenneth H. Cox. Built with Docusaurus.`,
     },

src/pages/index.tsx

@@ -19,7 +19,7 @@ function HomepageHeader() {
         <div className={styles.buttons}>
           <Link
             className="button button--secondary button--lg"
-            to="/docs/administrators-guide">
+            to="/docs/admin-guide">
             Hemlock Administrator's Guide
           </Link>
         </div>