Merge pull request #428 from mgreminger/docs-update

docs: add quick reference guide

Author: mgreminger

public/docs/accessible_reference.html

@@ -95,7 +95,7 @@
 
   const apiUrl = window.location.origin;
 
-  const tutorialHash = "fPMFb3PZhRKpfJuBaJ2HDR";
+  const tutorialHash = "hRLd9DHER22yb57AY82hmz";
 
   let termsAccepted = $state(appState.termsVersion);
 
@@ -2670,6 +2670,11 @@ Please include a link to this sheet in the email to assist in debugging the prob
       on:close={() => window.dispatchEvent(new Event('resize'))}
     >
       <SideNavItems>
+        <SideNavLink
+          href={`${window.location.origin}/docs/ep_quick_reference.pdf`}
+          text="Quick Reference Guide"
+          target="_blank"
+        />
         <SideNavMenu text="Example Sheets">
           {#each exampleSheets as {path, title} (path)}
             <SideNavMenuItem 

public/docs/ep_quick_reference.pdf

@@ -1,3 +1,15 @@
+<script lang="ts">
+  import { onMount } from "svelte";
+  import { renderMathInElement } from "mathlive";
+
+  onMount(() => {
+    const mathSpans = document.querySelectorAll(".math");
+    for (const span of mathSpans) {
+      renderMathInElement(span as HTMLElement);
+    }
+  });
+</script>
+
 <style>
   table {
     border-collapse: collapse;
@@ -17,11 +29,15 @@
 
 
 <p>
-    The following unit definintions are supported by EngineeringPaper.xyz (from <a
-        href="https://mathjs.org/docs/datatypes/units.html#reference">Math.js</a
-    >
-    documentation). Units may be used in their long or short forms (meter or m) and
-    they may be used in their singular or plural forms (second or seconds).
+    The following unit definintions are supported by EngineeringPaper.xyz (from
+    <a
+      href="https://mathjs.org/docs/datatypes/units.html#reference"
+      target="_blank"
+    >Math.js</a>
+    documentation). Units can be used in their long and short forms. Most units support 
+    long prefixes in their long form and short prefixes in their short form (e.g., kilogram or kg). Long form units generally support their singular and plural forms (e.g., meter or meters).
+    Units may be combined as needed using exponents, multiplication, and division, as in:
+    <span class="math">{String.raw`\(\left\lbrack\frac{kg}{m^3}\right\rbrack\text{or}\left\lbrack kg\cdot m^{-3}\right\rbrack\)`}</span> 
 </p>
 
 <table>

public/docs/ep_quick_reference.svg

@@ -8,9 +8,8 @@
 
   onMount(() => {
     const mathSpans = document.querySelectorAll(".math");
-    // @ts-ignore
     for (const span of mathSpans) {
-      renderMathInElement(span);
+      renderMathInElement(span as HTMLElement);
     }
   });
 </script>
@@ -26,6 +25,20 @@
   }
 </style>
 
+<em>July 27, 2026 (Permalink: <a href="https://20260717.engineeringpaper.xyz" target="_blank">20260727.engineeringpaper.xyz</a>)</em>
+<h4>Quick Reference Guide Added and Bug Fix</h4>
+<p>
+  A 4 page PDF 
+  <a
+    href="https://engineeringpaper.xyz/docs/ep_quick_reference.pdf"
+    target="_blank"
+  >quick reference guide</a> is now available in the left menu. The reference guide covers all 
+  of the cell types, all of the available functions, and all of the supported units.
+  Additionally, a bug that prevented Python Code Cell functions from being plotted in 
+  certain situations has been fixed.
+</p>
+<br>
+
 <em>June 12, 2026 (Permalink: <a href="https://20260612.engineeringpaper.xyz" target="_blank">20260612.engineeringpaper.xyz</a>)</em>
 <h4>Bug Fixes and Usability Improvements</h4>
 <p>

src/App.svelte

@@ -64,7 +64,7 @@ type AppState = {
 }
 
 const appState: AppState = $state<AppState>({
-  currentVersion: 20260612,
+  currentVersion: 20260727,
   termsVersion: 20240110,
 
   unsavedChange: false,

src/UnitsDocumentation.svelte

@@ -64,6 +64,7 @@ export default defineConfig(({ command, mode }) => {
             "mathlive/sounds/*",
             "logo_dark.svg",
             "print_logo.png",
+            "docs/ep_quick_reference.pdf",
             "assets/IBMPlexSans-Light-Latin1*.woff2",
             "assets/IBMPlexSans-Regular-Latin1*.woff2",
             "assets/IBMPlexSans-Regular-Greek*.woff2",