From 0711d6cb02d53fc4d256f9083ad354fc7d0efe1d Mon Sep 17 00:00:00 2001 From: Scott Norton Date: Wed, 29 Apr 2026 10:24:04 -0400 Subject: [PATCH] add Summary metadata mismatch to error table --- CrossClientCompatibility.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CrossClientCompatibility.md b/CrossClientCompatibility.md index 98cd157decf5..60fb602ff81e 100644 --- a/CrossClientCompatibility.md +++ b/CrossClientCompatibility.md @@ -180,6 +180,7 @@ The following are errors and telemetry warnings you may see during and following | --- | --- | --- | --- | | Telemetry Event | `MinVersionForCollabWarning` | Clients are joining with a version below your configured minimum, but are still able to understand the document's data format and therefore continue to collaborate. | If you see this warning message, it's likely a sign you updated `minVersionForCollab` too quickly. In future releases, ensure proper [saturation](#terminology) before updating. If these warning messages are ignored, you may risk seeing the below error in the future. | | `DataProcessingError` | `Document can't be opened with current version of the code` | An out-of-window client tried to join and was blocked due to being unable to collaborate with the newer client's document. | If this was unexpected, lower `minVersionForCollab` so newly-created documents will admit older clients. **Note:** documents whose schema has already been elevated by a higher-`minVersionForCollab` writer may continue to block older clients on those specific documents — lowering the configured value does not retroactively undo the elevation in the document's persisted schema. | +| `DataCorruptionError` | `Summary metadata mismatch` | An older client (before 2.0.0-rc.3.0.0) tried to load a document with `explicitSchemaControl` enabled. The older client is blocked to prevent data corruption. | Update the affected client to 2.0 or later. This signal only affects very old clients; modern cross-client enforcement surfaces through `MinVersionForCollabWarning` and the `DataProcessingError` row above. | | `UsageError` | `Incompatible Runtime Option` | You manually enabled a feature that requires a higher minimum than your document allows. | Turn the feature off or raise `minVersionForCollab` (if there is proper [saturation](#terminology)). | | `UsageError` | `Runtime option : requires runtime version ` | You manually enabled a feature that requires a higher minimum than your document allows. | Turn the feature off or raise `minVersionForCollab` (if there is proper [saturation](#terminology)). |