diff --git a/docs/gh-actions/gh-errors.md b/docs/gh-actions/gh-errors.md
index eaaa9d07008..0f757e0e7ce 100644
--- a/docs/gh-actions/gh-errors.md
+++ b/docs/gh-actions/gh-errors.md
@@ -1,31 +1,34 @@
-## Most Common Mistakes
-
-!!! tip "Username, Not Pictures"
- If you've been around the DIY community for a while, you know the mantra about screenshots. Well, when using a browser to build, **screenshots are close to useless**.
+## Help with Errors
If you get an error when building with a browser, use this page to figure out what to do.
-If you are still unsuccessful, then post your request for help along with your GitHub **username**. Mentors can go to your public GitHub repository, check the status and then view your log files directly.
+If you are still unsuccessful, then post your request for help along with your GitHub **username**. Mentors can go to your public GitHub repository, check the status and then view your log files directly.
* Do not copy from the log file and post the words
* Do not take a screenshot of what you think is an error
* Just post your username and the name of the app you are trying to build
+!!! tip "Username, Not Pictures"
+ If you've been around the DIY community for a while, you know the mantra about screenshots. Well, when using a browser to build, **screenshots are close to useless**.
+
But first - try to diagnose it yourself using this page.
+### Most Common Mistakes
+
These are some of the most common errors to date.
-* Make a spelling error when adding Secrets
+* Common mistake: you made a spelling error when adding Secrets
* Each secret must be spelled exactly the way it is presented in the instructions
-* Save your Secrets, as directed, but use a smart editor instead of a text-only editor
+ * If you are using an automatic translation, please keep an original page open too and copy from it to make sure there are no spelling errors in the secret name
+* Common mistake: use a smart editor instead of a text-only editor to save your information
* It only takes one letter to be changed from lower-case to upper-case by your smart editor to ruin your day
* The alpha-numeric values used for `GH_PAT`, `FASTLANE_ISSUER_ID` and `FASTLANE_KEY` contain both upper and lower-case characters and all the values are case-sensitive
-* When entering `TEAMID`, make a spelling error in the value - please copy and paste instead of typing what you think you see
- * If you type in your `TEAMID` as `0123498989` when it is really `012349B989`, you may not notice
- * Hint: what should have been the letter `B`, got typed as the number `8`
- * The incorrect `TEAMID` will show up in your identifiers as the `Bundle ID` but . . .
- * You will not be able to `Create Certificates` or `Build Loop` because your `TEAMID` does not match the `Bundle ID`
-* Run the actions out of order or skip one
+* Common mistake: when saving `TEAMID`, you type what you think you see instead of using copy and paste
+* Common mistake: skip running one of the actions
+
+If you are running development code, skip ahead to [Preview for Version 3.4](#preview-for-version-34).
+
+The next section is valid for Version 3.2.x and earlier.
## Find Your Error
@@ -443,3 +446,36 @@ These steps are needed to reset your `Match-Secrets`:
If you add an app to your *GitHub* username (by forking the repository and adding Secrets) and then build it, it encrypts your `Certificate` using `MATCH_PASSWORD`.
If you already have the other apps configured and then you delete `Match-Secrets` and add a new one, you will need to run `Create Certificates` for each app before the next time you build each app - go ahead and do that now so you don't forget.
+
+## Preview for Version 3.4
+
+When dev is released as Version 3.4.0, this will be the error finding section in LoopDocs.
+
+Error annotations are available for Version 3.3.0 and later. These were contributed by community volunteers along with the improvements to enable automatic updates and automatic builds.
+
+## Examine Annotation
+
+If a GitHub Action fails, you will see a clear notification.
+
+First consider the following results from the GitHub Action: 1. Validate Secrets.
+
+Your screen may look similar to the graphic below. The name in parentheses refers to the branch used to develop these wonderful messages. Yours may be (dev) or (main), once 3.4.0 is released.
+
+{width="500"}
+{align="center"}
+
+But there are so many reasons why this could happen. The first step is to click on the link highlighted by the red rectangle in the graphic above. This opens a new detailed view. The GIF below shows two different error messages. The first frame shows the error in the Annotation box at the bottom (you may need to scroll down to see this), and you may need to click on "Show More" to see the full message as seen in the second frame. The third frame of the GIF shows a different message. Each one these messages is designed to make it easier for you to diagnose your own problem.
+
+{width="800"}
+{align="center"}
+
+Notice that GitHub Action: 1. Validate Secrets is broken into three jobs each of which will either pass and show a green check or fail and show a red check. The secrets are validated with each action, so you will see this a lot.
+
+For example, the graphic below shows a failure of GitHub Action: 3. Create Certificates .
+
+{width="800"}
+{align="center"}
+
+This is an example of a message that is not terribly descriptive - which is why it is shown here. In this case, you can click on just the one job that failed. There will be less to sort through to find your error. The most likely reason for this error is [Error: Could not decrypt](#error-could-not-create).
+
+If you run across an error that does not have a nice message, be sure to post as discussed in [Help with Errors](#help-with-errors). You may be contributing to future improvements for this process.
diff --git a/docs/gh-actions/img/error-annotations-validate-secrets.gif b/docs/gh-actions/img/error-annotations-validate-secrets.gif
new file mode 100644
index 00000000000..c95d7c578c2
Binary files /dev/null and b/docs/gh-actions/img/error-annotations-validate-secrets.gif differ
diff --git a/docs/gh-actions/img/error-create-certs.png b/docs/gh-actions/img/error-create-certs.png
new file mode 100644
index 00000000000..2017afda5b8
Binary files /dev/null and b/docs/gh-actions/img/error-create-certs.png differ
diff --git a/docs/gh-actions/img/error-validate-secrets.png b/docs/gh-actions/img/error-validate-secrets.png
new file mode 100644
index 00000000000..14023e64bda
Binary files /dev/null and b/docs/gh-actions/img/error-validate-secrets.png differ