From 26fda738f4ddfdba454b072a3dd0f174d1f50060 Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Wed, 8 May 2024 16:17:44 +0200 Subject: [PATCH 1/7] Add deprecation log topic --- site/content/3.12/develop/http-api/monitoring/logs.md | 5 +++++ .../3.12/release-notes/version-3.12/api-changes-in-3-12.md | 4 ++++ 2 files changed, 9 insertions(+) diff --git a/site/content/3.12/develop/http-api/monitoring/logs.md b/site/content/3.12/develop/http-api/monitoring/logs.md index 6a6d6805fd..4d60756d33 100644 --- a/site/content/3.12/develop/http-api/monitoring/logs.md +++ b/site/content/3.12/develop/http-api/monitoring/logs.md @@ -444,6 +444,11 @@ paths: description: | One of the possible log topics. type: string + deprecation: + description: | + Warns about deprecated features and the usage of options that + will not be allowed or have no effect in a future version. + type: string development: description: | One of the possible log topics. diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index 916cff32d7..53279263de 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -195,6 +195,10 @@ longer use the `ldap` log topic. Changing the log level of the `ldap` topic or any other unknown topic is not an error, however. Also see [Incompatible changes in ArangoDB 3.12](incompatible-changes-in-3-12.md#ldap-authentication-support-removed). +A new `deprecation` log topic has been added. It warns about deprecated features +and the usage of options that will not be allowed or have no effect in a future +version. + #### Error code `12` removed The unused error `ERROR_OUT_OF_MEMORY_MMAP` with the number `12` has been removed. From be57b13884ba5e6656a3059b3498a5445907bad5 Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Wed, 8 May 2024 16:34:29 +0200 Subject: [PATCH 2/7] Release notes about stricter validation --- .../version-3.12/api-changes-in-3-12.md | 15 ++++++++++++--- .../version-3.12/incompatible-changes-in-3-12.md | 7 +++++++ 2 files changed, 19 insertions(+), 3 deletions(-) diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index 53279263de..f36686ad77 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -59,11 +59,20 @@ characters using the default settings. #### Collection API When creating a collection using the `POST /_api/collection` endpoint, the -server log now displays a deprecation message if illegal combinations and +server log now displays a `deprecation` message if illegal combinations and unknown attributes and values are detected in the request body. -Note that all invalid elements and combinations will be rejected in future -versions. +Note that all invalid elements and value combinations will be rejected in future +versions. The following options are already validated more strictly in v3.12 +and lead to error: + +- `keyOptions`: The `increment` and `offset` sub-attributes are only allowed if + the `type` sub-attribute is `"autoincrement"`. The `lastValue` sub-attribute + is only allowed if the `type` sub-attribute is `"traditional"`, `"autoincrement"`, + or `"padded"`. +- `isSmartChild`: If specified, the attribute must have a boolean value. +- `internalValidatorType`: If specified, the attribute must have an unsigned integer value. +- `shardKeys`: Each array element needs to be a string. #### Index API diff --git a/site/content/3.12/release-notes/version-3.12/incompatible-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/incompatible-changes-in-3-12.md index db559a61c9..0e9658485c 100644 --- a/site/content/3.12/release-notes/version-3.12/incompatible-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/incompatible-changes-in-3-12.md @@ -206,6 +206,13 @@ or user-defined AQL functions (UDFs), compare or sort strings in them, and Unicode characters for which the standard has changed between the two ICU versions are involved. +## Stricter option validation when creating collections + +Some invalid attributes and values that you can specify in the HTTP API when +creating collections are no longer allowed. Previous versions ignored these +invalid options. See [API Changes in ArangoDB 3.12](api-changes-in-3-12.md#collection-api) +for details. + ## Control character escaping in audit log The audit log feature of the Enterprise Edition previously logged query strings From 54cebdd47c0c11cc029a6b314654ec1ed1070f41 Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Wed, 8 May 2024 16:35:27 +0200 Subject: [PATCH 3/7] Minor improvement to the JS API descriptions --- .../develop/javascript-api/@arangodb/collection-object.md | 8 ++++---- .../3.12/develop/javascript-api/@arangodb/db-object.md | 6 ++++-- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/site/content/3.12/develop/javascript-api/@arangodb/collection-object.md b/site/content/3.12/develop/javascript-api/@arangodb/collection-object.md index 84efc05d4a..8765328ca1 100644 --- a/site/content/3.12/develop/javascript-api/@arangodb/collection-object.md +++ b/site/content/3.12/develop/javascript-api/@arangodb/collection-object.md @@ -208,11 +208,11 @@ Returns an object containing all collection properties. auto-generate keys in this case are not aware of all keys which are already used. {{< /warning >}} - `increment` (number): The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. - `offset` (number): The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. - - `lastValue` (number): the current offset value of the `autoincrement` or `padded` - key generator. This an internal property for restoring dumps properly. + Not used by other key generator types. + - `lastValue` (number): the offset value of the `autoincrement` or `padded` + key generator. This is an internal property for restoring dumps properly. - `schema` (object\|null): An object that specifies the collection-level document schema for documents. diff --git a/site/content/3.12/develop/javascript-api/@arangodb/db-object.md b/site/content/3.12/develop/javascript-api/@arangodb/db-object.md index 20dfb1d138..5693d93124 100644 --- a/site/content/3.12/develop/javascript-api/@arangodb/db-object.md +++ b/site/content/3.12/develop/javascript-api/@arangodb/db-object.md @@ -272,9 +272,11 @@ error is thrown. For information about the naming constraints for collections, s auto-generate keys in this case are not aware of all keys which are already used. {{< /warning >}} - `increment`: The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not allowed for other key generator types. - `offset`: The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not allowed for other key generator types. + - `lastValue`: the offset value for the `autoincrement` or `padded` + key generator. This is an internal property for restoring dumps properly. - `schema` (object\|null, _optional_, default: `null`): An object that specifies the collection-level document schema for documents. From a22be34cc6b3d9703f474449ece453187dd471b2 Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Wed, 8 May 2024 16:46:33 +0200 Subject: [PATCH 4/7] Fix HTTP API required attributes, minor clarifications --- .../3.12/develop/http-api/collections.md | 55 ++++++++----------- 1 file changed, 22 insertions(+), 33 deletions(-) diff --git a/site/content/3.12/develop/http-api/collections.md b/site/content/3.12/develop/http-api/collections.md index 85248612bb..e1701ae791 100644 --- a/site/content/3.12/develop/http-api/collections.md +++ b/site/content/3.12/develop/http-api/collections.md @@ -375,7 +375,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -403,16 +402,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -706,7 +705,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -734,16 +732,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -1054,7 +1052,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -1082,16 +1079,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -1798,7 +1795,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -1826,16 +1822,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -2370,11 +2366,6 @@ paths: additional options for key generation. If specified, then `keyOptions` should be a JSON object containing the following attributes: type: object - required: - - type - - allowUserKeys - - increment - - offset properties: type: description: | @@ -2427,13 +2418,13 @@ paths: type: boolean increment: description: | - increment value for `autoincrement` key generator. Not used for other key - generator types. + The increment value for the `autoincrement` key generator. + Not allowed for other key generator types. type: integer offset: description: | - Initial offset value for `autoincrement` key generator. - Not used for other key generator types. + The initial offset value for the `autoincrement` key generator. + Not allowed for other key generator types. type: integer type: description: | @@ -2690,7 +2681,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -2718,16 +2708,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value for the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -4028,7 +4018,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -4056,16 +4045,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: From 0ce9033ade3153d6d9f13b8c4b732cade6950fbb Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Fri, 31 May 2024 12:53:03 +0200 Subject: [PATCH 5/7] Don't mention internally used attributes isSmartChild and internalValidatorType in release notes --- .../3.12/release-notes/version-3.12/api-changes-in-3-12.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index f36686ad77..fea22fdf1d 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -70,8 +70,6 @@ and lead to error: the `type` sub-attribute is `"autoincrement"`. The `lastValue` sub-attribute is only allowed if the `type` sub-attribute is `"traditional"`, `"autoincrement"`, or `"padded"`. -- `isSmartChild`: If specified, the attribute must have a boolean value. -- `internalValidatorType`: If specified, the attribute must have an unsigned integer value. - `shardKeys`: Each array element needs to be a string. #### Index API From 554e71197d5f7d0b5d355be7c00c34b7c5d1192b Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Fri, 31 May 2024 12:55:00 +0200 Subject: [PATCH 6/7] Apply to 3.13 --- .../3.13/develop/http-api/collections.md | 55 ++++++++----------- .../3.13/develop/http-api/monitoring/logs.md | 5 ++ .../@arangodb/collection-object.md | 8 +-- .../javascript-api/@arangodb/db-object.md | 6 +- .../version-3.12/api-changes-in-3-12.md | 17 +++++- .../incompatible-changes-in-3-12.md | 7 +++ 6 files changed, 56 insertions(+), 42 deletions(-) diff --git a/site/content/3.13/develop/http-api/collections.md b/site/content/3.13/develop/http-api/collections.md index 85248612bb..e1701ae791 100644 --- a/site/content/3.13/develop/http-api/collections.md +++ b/site/content/3.13/develop/http-api/collections.md @@ -375,7 +375,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -403,16 +402,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -706,7 +705,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -734,16 +732,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -1054,7 +1052,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -1082,16 +1079,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -1798,7 +1795,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -1826,16 +1822,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -2370,11 +2366,6 @@ paths: additional options for key generation. If specified, then `keyOptions` should be a JSON object containing the following attributes: type: object - required: - - type - - allowUserKeys - - increment - - offset properties: type: description: | @@ -2427,13 +2418,13 @@ paths: type: boolean increment: description: | - increment value for `autoincrement` key generator. Not used for other key - generator types. + The increment value for the `autoincrement` key generator. + Not allowed for other key generator types. type: integer offset: description: | - Initial offset value for `autoincrement` key generator. - Not used for other key generator types. + The initial offset value for the `autoincrement` key generator. + Not allowed for other key generator types. type: integer type: description: | @@ -2690,7 +2681,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -2718,16 +2708,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value for the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: @@ -4028,7 +4018,6 @@ paths: required: - type - allowUserKeys - - lastValue properties: type: description: | @@ -4056,16 +4045,16 @@ paths: increment: description: | The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer offset: description: | The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. type: integer lastValue: description: | - The current offset value of the `autoincrement` or `padded` key generator. + The offset value of the `autoincrement` or `padded` key generator. This is an internal property for restoring dumps properly. type: integer cacheEnabled: diff --git a/site/content/3.13/develop/http-api/monitoring/logs.md b/site/content/3.13/develop/http-api/monitoring/logs.md index 6a6d6805fd..4d60756d33 100644 --- a/site/content/3.13/develop/http-api/monitoring/logs.md +++ b/site/content/3.13/develop/http-api/monitoring/logs.md @@ -444,6 +444,11 @@ paths: description: | One of the possible log topics. type: string + deprecation: + description: | + Warns about deprecated features and the usage of options that + will not be allowed or have no effect in a future version. + type: string development: description: | One of the possible log topics. diff --git a/site/content/3.13/develop/javascript-api/@arangodb/collection-object.md b/site/content/3.13/develop/javascript-api/@arangodb/collection-object.md index 84efc05d4a..8765328ca1 100644 --- a/site/content/3.13/develop/javascript-api/@arangodb/collection-object.md +++ b/site/content/3.13/develop/javascript-api/@arangodb/collection-object.md @@ -208,11 +208,11 @@ Returns an object containing all collection properties. auto-generate keys in this case are not aware of all keys which are already used. {{< /warning >}} - `increment` (number): The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not used by other key generator types. - `offset` (number): The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. - - `lastValue` (number): the current offset value of the `autoincrement` or `padded` - key generator. This an internal property for restoring dumps properly. + Not used by other key generator types. + - `lastValue` (number): the offset value of the `autoincrement` or `padded` + key generator. This is an internal property for restoring dumps properly. - `schema` (object\|null): An object that specifies the collection-level document schema for documents. diff --git a/site/content/3.13/develop/javascript-api/@arangodb/db-object.md b/site/content/3.13/develop/javascript-api/@arangodb/db-object.md index 20dfb1d138..5693d93124 100644 --- a/site/content/3.13/develop/javascript-api/@arangodb/db-object.md +++ b/site/content/3.13/develop/javascript-api/@arangodb/db-object.md @@ -272,9 +272,11 @@ error is thrown. For information about the naming constraints for collections, s auto-generate keys in this case are not aware of all keys which are already used. {{< /warning >}} - `increment`: The increment value for the `autoincrement` key generator. - Not used for other key generator types. + Not allowed for other key generator types. - `offset`: The initial offset value for the `autoincrement` key generator. - Not used for other key generator types. + Not allowed for other key generator types. + - `lastValue`: the offset value for the `autoincrement` or `padded` + key generator. This is an internal property for restoring dumps properly. - `schema` (object\|null, _optional_, default: `null`): An object that specifies the collection-level document schema for documents. diff --git a/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md index 916cff32d7..fea22fdf1d 100644 --- a/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md @@ -59,11 +59,18 @@ characters using the default settings. #### Collection API When creating a collection using the `POST /_api/collection` endpoint, the -server log now displays a deprecation message if illegal combinations and +server log now displays a `deprecation` message if illegal combinations and unknown attributes and values are detected in the request body. -Note that all invalid elements and combinations will be rejected in future -versions. +Note that all invalid elements and value combinations will be rejected in future +versions. The following options are already validated more strictly in v3.12 +and lead to error: + +- `keyOptions`: The `increment` and `offset` sub-attributes are only allowed if + the `type` sub-attribute is `"autoincrement"`. The `lastValue` sub-attribute + is only allowed if the `type` sub-attribute is `"traditional"`, `"autoincrement"`, + or `"padded"`. +- `shardKeys`: Each array element needs to be a string. #### Index API @@ -195,6 +202,10 @@ longer use the `ldap` log topic. Changing the log level of the `ldap` topic or any other unknown topic is not an error, however. Also see [Incompatible changes in ArangoDB 3.12](incompatible-changes-in-3-12.md#ldap-authentication-support-removed). +A new `deprecation` log topic has been added. It warns about deprecated features +and the usage of options that will not be allowed or have no effect in a future +version. + #### Error code `12` removed The unused error `ERROR_OUT_OF_MEMORY_MMAP` with the number `12` has been removed. diff --git a/site/content/3.13/release-notes/version-3.12/incompatible-changes-in-3-12.md b/site/content/3.13/release-notes/version-3.12/incompatible-changes-in-3-12.md index db559a61c9..0e9658485c 100644 --- a/site/content/3.13/release-notes/version-3.12/incompatible-changes-in-3-12.md +++ b/site/content/3.13/release-notes/version-3.12/incompatible-changes-in-3-12.md @@ -206,6 +206,13 @@ or user-defined AQL functions (UDFs), compare or sort strings in them, and Unicode characters for which the standard has changed between the two ICU versions are involved. +## Stricter option validation when creating collections + +Some invalid attributes and values that you can specify in the HTTP API when +creating collections are no longer allowed. Previous versions ignored these +invalid options. See [API Changes in ArangoDB 3.12](api-changes-in-3-12.md#collection-api) +for details. + ## Control character escaping in audit log The audit log feature of the Enterprise Edition previously logged query strings From 2428ae7b1c8a686eeaf2b464fa39f5a9e31f519b Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Fri, 31 May 2024 13:01:56 +0200 Subject: [PATCH 7/7] Fix sentence --- .../3.12/release-notes/version-3.12/api-changes-in-3-12.md | 2 +- .../3.13/release-notes/version-3.12/api-changes-in-3-12.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index fea22fdf1d..2b6504c234 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -64,7 +64,7 @@ unknown attributes and values are detected in the request body. Note that all invalid elements and value combinations will be rejected in future versions. The following options are already validated more strictly in v3.12 -and lead to error: +and incorrect use can lead to errors: - `keyOptions`: The `increment` and `offset` sub-attributes are only allowed if the `type` sub-attribute is `"autoincrement"`. The `lastValue` sub-attribute diff --git a/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md index fea22fdf1d..2b6504c234 100644 --- a/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.13/release-notes/version-3.12/api-changes-in-3-12.md @@ -64,7 +64,7 @@ unknown attributes and values are detected in the request body. Note that all invalid elements and value combinations will be rejected in future versions. The following options are already validated more strictly in v3.12 -and lead to error: +and incorrect use can lead to errors: - `keyOptions`: The `increment` and `offset` sub-attributes are only allowed if the `type` sub-attribute is `"autoincrement"`. The `lastValue` sub-attribute