From 201bf926256a7906293a87965c2397b992ce0e7b Mon Sep 17 00:00:00 2001 From: leet-c1 <264029741+leet-c1@users.noreply.github.com> Date: Fri, 17 Jul 2026 19:15:07 +0000 Subject: [PATCH 1/2] docs: fix MDX parse crashes that broke mint broken-links repo-wide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two pages aborted the mint broken-links crawler (it stops at the first unparseable file, so no page could be link-checked): - developer/error-codes.mdx: `%s`/`%w` in `###` headings → URIError when Mintlify percent-decodes the generated heading anchor. Backticks don't help (the slug still contains the bare `%`), so the headings now use plain titles and the literal error strings moved into inline code in the body. - rap/cel-expressions/env-user-attribute.md: bare `list` in a table cell parsed as an unclosed JSX tag → wrapped in backticks, matching the repo-wide convention for angle-bracket types and placeholders. With these fixed, mint broken-links runs to completion and can link-check the whole repo. Co-Authored-By: Claude Opus 4.8 --- developer/error-codes.mdx | 16 ++++++++++++---- rap/cel-expressions/env-user-attribute.md | 2 +- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/developer/error-codes.mdx b/developer/error-codes.mdx index e4a6d978..98dd01cd 100644 --- a/developer/error-codes.mdx +++ b/developer/error-codes.mdx @@ -165,7 +165,9 @@ export C1Z_DECODER_MAX_MEMORY=4294967296 # 4GB **Solution:** Implement `CustomActionManager` if you need actions, or don't call action endpoints. -### Action %s not found +### Action not found + +Error message: `Action %s not found` **Cause:** Requested an action that doesn't exist. @@ -195,7 +197,9 @@ type ValidateProvider interface { } ``` -### Validate failed: %w +### Validate failed + +Error message: `Validate failed: %w` **Cause:** Connector validation failed (wrapped error contains details). @@ -246,7 +250,9 @@ export AWS_SECRET_ACCESS_KEY=your-secret ## Encryption errors -### Age: failed to encrypt: %w +### Age: failed to encrypt + +Error message: `Age: failed to encrypt: %w` **Cause:** Encryption failed (age library error). @@ -254,7 +260,9 @@ export AWS_SECRET_ACCESS_KEY=your-secret - Invalid recipient public key - Memory allocation failure -### Age: failed to decrypt: %w +### Age: failed to decrypt + +Error message: `Age: failed to decrypt: %w` **Cause:** Decryption failed. diff --git a/rap/cel-expressions/env-user-attribute.md b/rap/cel-expressions/env-user-attribute.md index 4d26cfd2..d48be022 100644 --- a/rap/cel-expressions/env-user-attribute.md +++ b/rap/cel-expressions/env-user-attribute.md @@ -110,7 +110,7 @@ c1.user.v1.HasEntitlement(subject, "app-id", "admin-role") | Profile field missing | Empty string | Use `has()` check | | Array index out of bounds | Runtime error | Check `size()` first | | String split with no delimiter | Single-element array | Handle single-element case | -| Wrong return type | Conversion error | Ensure string or list | +| Wrong return type | Conversion error | Ensure string or `list` | ## Best Practice From 6f9eae034aa6c6495181bdcc102e0b6bfeeefb94 Mon Sep 17 00:00:00 2001 From: leet-c1 <264029741+leet-c1@users.noreply.github.com> Date: Fri, 17 Jul 2026 19:31:40 +0000 Subject: [PATCH 2/2] docs: bold the Error message label for consistency (Copilot review) Match the surrounding **Cause:**/**Solution:** label style. Co-Authored-By: Claude Opus 4.8 --- developer/error-codes.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/developer/error-codes.mdx b/developer/error-codes.mdx index 98dd01cd..184ba8b2 100644 --- a/developer/error-codes.mdx +++ b/developer/error-codes.mdx @@ -167,7 +167,7 @@ export C1Z_DECODER_MAX_MEMORY=4294967296 # 4GB ### Action not found -Error message: `Action %s not found` +**Error message:** `Action %s not found` **Cause:** Requested an action that doesn't exist. @@ -199,7 +199,7 @@ type ValidateProvider interface { ### Validate failed -Error message: `Validate failed: %w` +**Error message:** `Validate failed: %w` **Cause:** Connector validation failed (wrapped error contains details). @@ -252,7 +252,7 @@ export AWS_SECRET_ACCESS_KEY=your-secret ### Age: failed to encrypt -Error message: `Age: failed to encrypt: %w` +**Error message:** `Age: failed to encrypt: %w` **Cause:** Encryption failed (age library error). @@ -262,7 +262,7 @@ Error message: `Age: failed to encrypt: %w` ### Age: failed to decrypt -Error message: `Age: failed to decrypt: %w` +**Error message:** `Age: failed to decrypt: %w` **Cause:** Decryption failed.