diff --git a/developer/error-codes.mdx b/developer/error-codes.mdx
index e4a6d978..184ba8b2 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<string> |
+| Wrong return type | Conversion error | Ensure string or `list<string>` |
 
 ## Best Practice