diff --git a/.github/workflows/build-multiarch.yml b/.github/workflows/build-multiarch.yml
index e5c893c6..fd844823 100644
--- a/.github/workflows/build-multiarch.yml
+++ b/.github/workflows/build-multiarch.yml
@@ -10,6 +10,7 @@ on:
       - "*.md"
       - "docs/**"
       - "examples/**"
+      - "notes/**"
 
 jobs:
   build:
diff --git a/.github/workflows/verify-pr.yml b/.github/workflows/verify-pr.yml
index 1c424ee1..4b288978 100644
--- a/.github/workflows/verify-pr.yml
+++ b/.github/workflows/verify-pr.yml
@@ -7,6 +7,7 @@ on:
       - "*.md"
       - "docs/**"
       - "examples/**"
+      - "notes/**"
       - "docker-compose*.yml"
       - "mkdocs.yml"
 
diff --git a/docs/versions/java.md b/docs/versions/java.md
index 3fc66a21..a052c54a 100644
--- a/docs/versions/java.md
+++ b/docs/versions/java.md
@@ -49,6 +49,10 @@ where `<tag>` refers to the first column of this table:
 
     The "latest" tag shifts to include not only the latest features and bug fixes, but also the latest Java version that Mojang requires for the latest Minecraft version.
 
+!!! tip "Class File Version"
+
+    If the Minecraft startup is logging an error about a "class file version", then refer [to this table](https://javaalmanac.io/bytecode/versions/) to identify the JDK/Java version corresponding to each class file version.
+
 ### Release versions
 
 Since the tags referenced above will shift as the newest image build brings in new features and bug fixes, released variants of those can also be used to pin a specific build of the image.
diff --git a/notes/Understanding class file version errors.drawio.png b/notes/Understanding class file version errors.drawio.png
new file mode 100644
index 00000000..ea406230
Binary files /dev/null and b/notes/Understanding class file version errors.drawio.png differ