diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authentication.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authentication.md
index b794fe3dc96..03190decb94 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authentication.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authentication.md
@@ -26,22 +26,22 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
| `polaris.authentication.type` | `internal` | `enum (INTERNAL, EXTERNAL, MIXED)` | The type of authentication to use. |
-| `polaris.authentication.credential-mode` | `internal` | `enum (INTERNAL, EXTERNAL)` | The credential mode to use. Valid values are `INTERNAL` and `EXTERNAL`.
Internal mode is the default. When internal mode is used, callers must have a corresponding principal in the Polaris metastore, which serves as the authoritative source of truth for principals, roles, and grants.
When external mode is used, callers are authenticated entirely from the presented credentials and are not required to have a corresponding entity in the Polaris metastore. Note that when the presented credentials were issued by Polaris itself, a backing principal entity is always required, regardless of the credential mode.
External credential mode is only meaningful when an external IDP is used, that is, when the authentication type (#type()) is (`AuthenticationType#EXTERNAL`) or (`AuthenticationType#MIXED`). Also, this mode is not compatible with the default, built-in Polaris authorizer; an external authorizer (e.g., OPA or Ranger) must be configured. |
-| `polaris.authentication.authenticator.type` | `default` | `string` | The type of the identity provider. Must be a registered (`Authenticator`) identifier. |
-| `polaris.authentication.token-service.type` | `default` | `string` | The type of the OAuth2 service. Must be a registered (`IcebergRestOAuth2ApiService`) identifier. |
+| `polaris.authentication.credential-mode` | `internal` | `enum (INTERNAL, EXTERNAL)` | The credential mode to use. Valid values are `INTERNAL` and `EXTERNAL`.
Internal mode is the default. When internal mode is used, callers must have a corresponding principal in the Polaris metastore, which serves as the authoritative source of truth for principals, roles, and grants.
When external mode is used, callers are authenticated entirely from the presented credentials and are not required to have a corresponding entity in the Polaris metastore. Note that when the presented credentials were issued by Polaris itself, a backing principal entity is always required, regardless of the credential mode.
External credential mode is only meaningful when an external IDP is used, that is, when the authentication type (#type()) is (`AuthenticationType#EXTERNAL`) or (`AuthenticationType#MIXED`). Also, this mode is not compatible with the default, built-in Polaris authorizer; an external authorizer (e.g., OPA or Ranger) must be configured. |
+| `polaris.authentication.authenticator.type` | `default` | `string` | The type of the identity provider. Must be a registered (`Authenticator`) identifier. |
+| `polaris.authentication.token-service.type` | `default` | `string` | The type of the OAuth2 service. Must be a registered (`IcebergRestOAuth2ApiService`) identifier. |
| `polaris.authentication.token-broker.max-token-generation` | `PT1H` | `duration` | The maximum token duration. |
-| `polaris.authentication.token-broker.type` | `rsa-key-pair` | `string` | The type of the token broker factory. Must be a registered (`TokenBrokerFactory`) identifier. |
+| `polaris.authentication.token-broker.type` | `rsa-key-pair` | `string` | The type of the token broker factory. Must be a registered (`TokenBrokerFactory`) identifier. |
| `polaris.authentication.token-broker.rsa-key-pair.public-key-file` | | `path` | The path to the public key file. |
| `polaris.authentication.token-broker.rsa-key-pair.private-key-file` | | `path` | The path to the private key file. |
-| `polaris.authentication.token-broker.symmetric-key.secret` | | `string` | The secret to use for both signing and verifying signatures. Either this option of (`#file()`) must be provided. |
-| `polaris.authentication.token-broker.symmetric-key.file` | | `path` | The file to read the secret from. Either this option of (`#secret()`) must be provided. |
+| `polaris.authentication.token-broker.symmetric-key.secret` | | `string` | The secret to use for both signing and verifying signatures. Either this option of (`#file()`) must be provided. |
+| `polaris.authentication.token-broker.symmetric-key.file` | | `path` | The file to read the secret from. Either this option of (`#secret()`) must be provided. |
| `polaris.authentication.`_``_`.type` | `internal` | `enum (INTERNAL, EXTERNAL, MIXED)` | The type of authentication to use. |
-| `polaris.authentication.`_``_`.credential-mode` | `internal` | `enum (INTERNAL, EXTERNAL)` | The credential mode to use. Valid values are `INTERNAL` and `EXTERNAL`.
Internal mode is the default. When internal mode is used, callers must have a corresponding principal in the Polaris metastore, which serves as the authoritative source of truth for principals, roles, and grants.
When external mode is used, callers are authenticated entirely from the presented credentials and are not required to have a corresponding entity in the Polaris metastore. Note that when the presented credentials were issued by Polaris itself, a backing principal entity is always required, regardless of the credential mode.
External credential mode is only meaningful when an external IDP is used, that is, when the authentication type (#type()) is (`AuthenticationType#EXTERNAL`) or (`AuthenticationType#MIXED`). Also, this mode is not compatible with the default, built-in Polaris authorizer; an external authorizer (e.g., OPA or Ranger) must be configured. |
-| `polaris.authentication.`_``_`.authenticator.type` | `default` | `string` | The type of the identity provider. Must be a registered (`Authenticator`) identifier. |
-| `polaris.authentication.`_``_`.token-service.type` | `default` | `string` | The type of the OAuth2 service. Must be a registered (`IcebergRestOAuth2ApiService`) identifier. |
+| `polaris.authentication.`_``_`.credential-mode` | `internal` | `enum (INTERNAL, EXTERNAL)` | The credential mode to use. Valid values are `INTERNAL` and `EXTERNAL`.
Internal mode is the default. When internal mode is used, callers must have a corresponding principal in the Polaris metastore, which serves as the authoritative source of truth for principals, roles, and grants.
When external mode is used, callers are authenticated entirely from the presented credentials and are not required to have a corresponding entity in the Polaris metastore. Note that when the presented credentials were issued by Polaris itself, a backing principal entity is always required, regardless of the credential mode.
External credential mode is only meaningful when an external IDP is used, that is, when the authentication type (#type()) is (`AuthenticationType#EXTERNAL`) or (`AuthenticationType#MIXED`). Also, this mode is not compatible with the default, built-in Polaris authorizer; an external authorizer (e.g., OPA or Ranger) must be configured. |
+| `polaris.authentication.`_``_`.authenticator.type` | `default` | `string` | The type of the identity provider. Must be a registered (`Authenticator`) identifier. |
+| `polaris.authentication.`_``_`.token-service.type` | `default` | `string` | The type of the OAuth2 service. Must be a registered (`IcebergRestOAuth2ApiService`) identifier. |
| `polaris.authentication.`_``_`.token-broker.max-token-generation` | `PT1H` | `duration` | The maximum token duration. |
-| `polaris.authentication.`_``_`.token-broker.type` | `rsa-key-pair` | `string` | The type of the token broker factory. Must be a registered (`TokenBrokerFactory`) identifier. |
+| `polaris.authentication.`_``_`.token-broker.type` | `rsa-key-pair` | `string` | The type of the token broker factory. Must be a registered (`TokenBrokerFactory`) identifier. |
| `polaris.authentication.`_``_`.token-broker.rsa-key-pair.public-key-file` | | `path` | The path to the public key file. |
| `polaris.authentication.`_``_`.token-broker.rsa-key-pair.private-key-file` | | `path` | The path to the private key file. |
-| `polaris.authentication.`_``_`.token-broker.symmetric-key.secret` | | `string` | The secret to use for both signing and verifying signatures. Either this option of (`#file()`) must be provided. |
-| `polaris.authentication.`_``_`.token-broker.symmetric-key.file` | | `path` | The file to read the secret from. Either this option of (`#secret()`) must be provided. |
+| `polaris.authentication.`_``_`.token-broker.symmetric-key.secret` | | `string` | The secret to use for both signing and verifying signatures. Either this option of (`#file()`) must be provided. |
+| `polaris.authentication.`_``_`.token-broker.symmetric-key.file` | | `path` | The file to read the secret from. Either this option of (`#secret()`) must be provided. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authorization_opa.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authorization_opa.md
index ab36a98957f..b84bc762997 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authorization_opa.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_authorization_opa.md
@@ -25,7 +25,7 @@ build:
Configuration for OPA (Open Policy Agent) authorization.
-Beta Feature: OPA authorization is currently in Beta and is not a stable release. It may undergo breaking changes in future versions. Use with caution in production environments.
+Beta Feature: OPA authorization is currently in Beta and is not a stable release. It may undergo breaking changes in future versions. Use with caution in production environments.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
@@ -34,8 +34,8 @@ Beta Feature: OPA authorization is currently in Beta and is not a stable releas
| `polaris.authorization.opa.auth.bearer.static-token.value` | | `string` | Static bearer token value |
| `polaris.authorization.opa.auth.bearer.file-based.path` | | `path` | Path to file containing bearer token |
| `polaris.authorization.opa.auth.bearer.file-based.refresh-interval` | | `duration` | How often to refresh file-based bearer tokens (defaults to 5 minutes if not specified) |
-| `polaris.authorization.opa.auth.bearer.file-based.jwt-expiration-refresh` | | `boolean` | Whether to automatically detect JWT tokens and use their 'exp' field for refresh timing. If true and the token is a valid JWT with an 'exp' claim, the token will be refreshed based on the expiration time minus the buffer, rather than the fixed refresh interval. Defaults to true if not specified. |
-| `polaris.authorization.opa.auth.bearer.file-based.jwt-expiration-buffer` | | `duration` | Buffer time before JWT expiration to refresh the token. Only used when jwtExpirationRefresh is true and the token is a valid JWT. Defaults to 1 minute if not specified. |
+| `polaris.authorization.opa.auth.bearer.file-based.jwt-expiration-refresh` | | `boolean` | Whether to automatically detect JWT tokens and use their 'exp' field for refresh timing. If true and the token is a valid JWT with an 'exp' claim, the token will be refreshed based on the expiration time minus the buffer, rather than the fixed refresh interval. Defaults to true if not specified. |
+| `polaris.authorization.opa.auth.bearer.file-based.jwt-expiration-buffer` | | `duration` | Buffer time before JWT expiration to refresh the token. Only used when jwtExpirationRefresh is true and the token is a valid JWT. Defaults to 1 minute if not specified. |
| `polaris.authorization.opa.auth.bearer.file-based.initial-token-wait` | | `duration` | How long to wait for the first token load before failing a request. Defaults to 5 seconds. |
| `polaris.authorization.opa.auth.bearer.file-based.refresh-retry-interval` | | `duration` | How long to wait before retrying after a failed token refresh. Defaults to 1 second. |
| `polaris.authorization.opa.http.timeout` | `PT2S` | `duration` | |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_credential_manager.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_credential_manager.md
index 42f76f8a60b..5a78fd99cf0 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_credential_manager.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_credential_manager.md
@@ -25,8 +25,8 @@ build:
Quarkus configuration mapping for Polaris Credential Manager.
-Defines which (`PolarisCredentialManager`) implementation should be used at runtime. This allows switching between different credential management strategies via configuration.
+Defines which (`PolarisCredentialManager`) implementation should be used at runtime. This allows switching between different credential management strategies via configuration.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.credential-manager.type` | | `string` | The type identifier of the PolarisCredentialManager implementation to use. This corresponds to the `@Identifier` annotation value on the implementation (e.g., "default"). |
+| `polaris.credential-manager.type` | | `string` | The type identifier of the PolarisCredentialManager implementation to use. This corresponds to the `@Identifier` annotation value on the implementation (e.g., "default"). |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener.md
index 8fc6edfbfae..04009a3f2f2 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener.md
@@ -25,11 +25,11 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.event-listener.type` | | `string` | The type of the event listener to use. Must be a registered (`PolarisEventListener`) identifier.
_Deprecated_ since 1.5.0, use 'polaris.event-listener.types' instead, if both are set, then polaris.event-listener.types is prioritized |
-| `polaris.event-listener.types` | | `list of string` | Comma separated list of event listeners, each item must be a registered (`PolarisEventListener`) identifier. |
+| `polaris.event-listener.type` | | `string` | The type of the event listener to use. Must be a registered (`PolarisEventListener`) identifier.
_Deprecated_ since 1.5.0, use 'polaris.event-listener.types' instead, if both are set, then polaris.event-listener.types is prioritized |
+| `polaris.event-listener.types` | | `list of string` | Comma separated list of event listeners, each item must be a registered (`PolarisEventListener`) identifier. |
| `polaris.event-listener.denylisted-attributes` | | `list of string` | Comma-separated list of additional EventAttributes key names to deny from downstream listeners. These are added to the built-in denylist in (`DefaultEventSanitizer`). |
-| `polaris.event-listener.`_``_`.enabled-event-types` | | list of enum (BEFORE_CREATE_CATALOG, AFTER_CREATE_CATALOG, BEFORE_DELETE_CATALOG, ...) | Comma separated list of enabled event types. This event listener will only receive events of the selected types. If both the event types and event category configs are set, the listener will listen to both. If no listener configuration is present, then all event types are enabled. |
-| `polaris.event-listener.`_``_`.enabled-event-categories` | | list of enum (CATALOG, NAMESPACE, TABLE, ...) | Comma separated list of enabled event type categories. Each category is a collection of related Polaris event types. This event listener will only receive events of the selected event category, for example, consume only catalog events. If both the event types and event category configs are set, the listener will listen to both. If no listener configuration is present, then all event types are enabled. |
-| `polaris.event-listener.executor.pool-size` | `-1` | `int` | The thread pool size. The default is -1, which is interpreted as the number of available listeners, capped by the number of cores |
-| `polaris.event-listener.executor.queue-size` | `-1` | `int` | The queue size. The default is -1, which is interpreted as unbounded. This limit is applied globally and affects all listeners. To configure the per-listener queue size, use `polaris.event-listener.listener-backlog.queue-size` instead. |
-| `polaris.event-listener.listener-backlog.queue-size` | `-1` | `int` | The per-listener backlog queue size. The default is -1, which is interpreted as unbounded. A bounded backlog means event delivery is best-effort and events will be dropped/logged when the backlog is full. |
+| `polaris.event-listener.`_``_`.enabled-event-types` | | list of enum (BEFORE_CREATE_CATALOG, AFTER_CREATE_CATALOG, BEFORE_DELETE_CATALOG, ...) | Comma separated list of enabled event types. This event listener will only receive events of the selected types. If both the event types and event category configs are set, the listener will listen to both. If no listener configuration is present, then all event types are enabled. |
+| `polaris.event-listener.`_``_`.enabled-event-categories` | | list of enum (CATALOG, NAMESPACE, TABLE, ...) | Comma separated list of enabled event type categories. Each category is a collection of related Polaris event types. This event listener will only receive events of the selected event category, for example, consume only catalog events. If both the event types and event category configs are set, the listener will listen to both. If no listener configuration is present, then all event types are enabled. |
+| `polaris.event-listener.executor.pool-size` | `-1` | `int` | The thread pool size. The default is -1, which is interpreted as the number of available listeners, capped by the number of cores |
+| `polaris.event-listener.executor.queue-size` | `-1` | `int` | The queue size. The default is -1, which is interpreted as unbounded. This limit is applied globally and affects all listeners. To configure the per-listener queue size, use `polaris.event-listener.listener-backlog.queue-size` instead. |
+| `polaris.event-listener.listener-backlog.queue-size` | `-1` | `int` | The per-listener backlog queue size. The default is -1, which is interpreted as unbounded. A bounded backlog means event delivery is best-effort and events will be dropped/logged when the backlog is full. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_aws_cloudwatch.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_aws_cloudwatch.md
index 3cbd6402f05..99fe3db7f16 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_aws_cloudwatch.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_aws_cloudwatch.md
@@ -27,7 +27,7 @@ Configuration interface for AWS CloudWatch event listener integration.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.event-listener.aws-cloudwatch.log-group` | `polaris-cloudwatch-default-group` | `string` | Returns the AWS CloudWatch log group name for event logging.
The log group is a collection of log streams that share the same retention, monitoring, and access control settings. If not specified, defaults to "polaris-cloudwatch-default-group".
Configuration property: `polaris.event-listener.aws-cloudwatch.log-group` |
-| `polaris.event-listener.aws-cloudwatch.log-stream` | `polaris-cloudwatch-default-stream` | `string` | Returns the AWS CloudWatch log stream name for event logging.
A log stream is a sequence of log events that share the same source. Each log stream belongs to one log group. If not specified, defaults to "polaris-cloudwatch-default-stream".
Configuration property: `polaris.event-listener.aws-cloudwatch.log-stream` |
-| `polaris.event-listener.aws-cloudwatch.region` | `us-east-1` | `string` | Returns the AWS region where CloudWatch logs should be sent.
This specifies the AWS region for the CloudWatch service endpoint. The region must be a valid AWS region identifier. If not specified, defaults to "us-east-1".
Configuration property: `polaris.event-listener.aws-cloudwatch.region` |
-| `polaris.event-listener.aws-cloudwatch.synchronous-mode` | `false` | `boolean` | Returns the synchronous mode setting for CloudWatch logging.
When set to "true", log events are sent to CloudWatch synchronously, which may impact application performance but ensures immediate delivery. When set to "false" (default), log events are sent asynchronously for better performance.
Configuration property: `polaris.event-listener.aws-cloudwatch.synchronous-mode` |
+| `polaris.event-listener.aws-cloudwatch.log-group` | `polaris-cloudwatch-default-group` | `string` | Returns the AWS CloudWatch log group name for event logging.
The log group is a collection of log streams that share the same retention, monitoring, and access control settings. If not specified, defaults to "polaris-cloudwatch-default-group".
Configuration property: `polaris.event-listener.aws-cloudwatch.log-group` |
+| `polaris.event-listener.aws-cloudwatch.log-stream` | `polaris-cloudwatch-default-stream` | `string` | Returns the AWS CloudWatch log stream name for event logging.
A log stream is a sequence of log events that share the same source. Each log stream belongs to one log group. If not specified, defaults to "polaris-cloudwatch-default-stream".
Configuration property: `polaris.event-listener.aws-cloudwatch.log-stream` |
+| `polaris.event-listener.aws-cloudwatch.region` | `us-east-1` | `string` | Returns the AWS region where CloudWatch logs should be sent.
This specifies the AWS region for the CloudWatch service endpoint. The region must be a valid AWS region identifier. If not specified, defaults to "us-east-1".
Configuration property: `polaris.event-listener.aws-cloudwatch.region` |
+| `polaris.event-listener.aws-cloudwatch.synchronous-mode` | `false` | `boolean` | Returns the synchronous mode setting for CloudWatch logging.
When set to "true", log events are sent to CloudWatch synchronously, which may impact application performance but ensures immediate delivery. When set to "false" (default), log events are sent asynchronously for better performance.
Configuration property: `polaris.event-listener.aws-cloudwatch.synchronous-mode` |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_kafka.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_kafka.md
index e3b35c9a038..ee381ccd6bb 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_kafka.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_event_listener_kafka.md
@@ -25,28 +25,28 @@ build:
Configuration for the Kafka Event Listener.
-Publishes Polaris events to a Kafka topic. The key for the Kafka record is the UUID of the Polaris event. To preserve FIFO behavior in the Kafka stream of the Polaris events a single partition should be used.
+Publishes Polaris events to a Kafka topic. The key for the Kafka record is the UUID of the Polaris event. To preserve FIFO behavior in the Kafka stream of the Polaris events a single partition should be used.
-The value of Kafka record is JSON encoded as a String. It consists of a set of key values. The set of keys included depends on the Polaris event type and are listed below. The type of value is String except for keys source, destination, table_identifier, view_identifier, namespace and activated_roles which are all encoded as an array of Strings.
+The value of Kafka record is JSON encoded as a String. It consists of a set of key values. The set of keys included depends on the Polaris event type and are listed below. The type of value is String except for keys source, destination, table_identifier, view_identifier, namespace and activated_roles which are all encoded as an array of Strings.
- * event_type
- * timestamp (ISO-8601 representation)
- * source (source of table rename if the event is a table rename)
- * destination (destination of table rename if the event is a table rename)
- * table_name
- * namespace
- * table_identifier
- * view_identifier
- * view_name
- * namespace_name
- * catalog_name
- * realm_id
- * principal
- * activated_roles
+ * event_type
+ * timestamp (ISO-8601 representation)
+ * source (source of table rename if the event is a table rename)
+ * destination (destination of table rename if the event is a table rename)
+ * table_name
+ * namespace
+ * table_identifier
+ * view_identifier
+ * view_name
+ * namespace_name
+ * catalog_name
+ * realm_id
+ * principal
+ * activated_roles
* request_id
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
| `polaris.event-listener.kafka.topic` | `polaris-catalog-events` | `string` | The Kafka topic to send Polaris events to.
Configuration property: `polaris.event-listener.kafka.topic` |
-| `polaris.event-listener.kafka.synchronous-mode` | `false` | `boolean` | The synchronous mode setting for sending events to Kafka.
When set to "true", when events are sent to Kafka the event handling thread will wait for the events to be delivered to Kafka, which may impact performance. When set to "false" (default), events are sent asynchronously.
Configuration property: `polaris.event-listener.kafka.synchronous-mode` |
-| `polaris.event-listener.kafka.properties.`_``_ | | `string` | Kafka properties to pass to the Kafka client producer, for example bootstrap.servers is required. This can be used to configure authentication (e.g., SASL, SSL) or other Kafka producer properties.
Configuration property: `polaris.event-listener.kafka.properties` |
+| `polaris.event-listener.kafka.synchronous-mode` | `false` | `boolean` | The synchronous mode setting for sending events to Kafka.
When set to "true", when events are sent to Kafka the event handling thread will wait for the events to be delivered to Kafka, which may impact performance. When set to "false" (default), events are sent asynchronously.
Configuration property: `polaris.event-listener.kafka.synchronous-mode` |
+| `polaris.event-listener.kafka.properties.`_``_ | | `string` | Kafka properties to pass to the Kafka client producer, for example bootstrap.servers is required. This can be used to configure authentication (e.g., SASL, SSL) or other Kafka producer properties.
Configuration property: `polaris.event-listener.kafka.properties` |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_file_io.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_file_io.md
index a4cd5db602e..a2775c0f2bd 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_file_io.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_file_io.md
@@ -25,4 +25,4 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.file-io.type` | | `string` | The type of the catalog IO to use. Must be a registered (`org.apache.polaris.service.catalog.io.FileIOFactory`) identifier. |
+| `polaris.file-io.type` | | `string` | The type of the catalog IO to use. Must be a registered (`org.apache.polaris.service.catalog.io.FileIOFactory`) identifier. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_idempotency.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_idempotency.md
index 2561f3f3755..c6ad14657d6 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_idempotency.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_idempotency.md
@@ -25,9 +25,9 @@ build:
Deploy-time configuration for entity-property (single-transaction) idempotency.
-This model embeds the `Idempotency-Key` directly into the `internalProperties` of the entity created by the originating operation, so the key and the operation commit atomically. There is no separate idempotency store, so the configuration surface is intentionally minimal: just a feature flag and the key TTL.
+This model embeds the `Idempotency-Key` directly into the `internalProperties` of the entity created by the originating operation, so the key and the operation commit atomically. There is no separate idempotency store, so the configuration surface is intentionally minimal: just a feature flag and the key TTL.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.idempotency.enabled` | `false` | `boolean` | Whether handler-level idempotency is enabled. When `false` the handlers ignore the `Idempotency-Key` header entirely and never stamp or read idempotency keys. |
-| `polaris.idempotency.ttl` | `PT5M` | `duration` | TTL for newly recorded idempotency keys. A retry that arrives within this window of a successful create replays the existing table; after it elapses the key is treated as absent and dropped inline on the entity's next write. |
+| `polaris.idempotency.enabled` | `false` | `boolean` | Whether handler-level idempotency is enabled. When `false` the handlers ignore the `Idempotency-Key` header entirely and never stamp or read idempotency keys. |
+| `polaris.idempotency.ttl` | `PT5M` | `duration` | TTL for newly recorded idempotency keys. A retry that arrives within this window of a successful create replays the existing table; after it elapses the key is treated as absent and dropped inline on the entity's next write. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_metrics.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_metrics.md
index 09d2b130470..222adf71e56 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_metrics.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_metrics.md
@@ -26,8 +26,8 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
| `polaris.metrics.tags.`_``_ | | `string` | Additional tags to include in the metrics. |
-| `polaris.metrics.realm-id-tag.enable-in-api-metrics` | `false` | `boolean` | Whether to include the Realm ID tag in the API request metrics.
Beware that if the cardinality of this tag is too high, it can cause performance issues or even crash the server. |
-| `polaris.metrics.realm-id-tag.enable-in-http-metrics` | `false` | `boolean` | Whether to include the Realm ID tag in the HTTP server request metrics.
Beware that if the cardinality of this tag is too high, it can cause performance issues or even crash the server. |
-| `polaris.metrics.realm-id-tag.http-metrics-max-cardinality` | `100` | `int` | The maximum number of Realm ID tag values allowed for the HTTP server request metrics.
This is used to prevent the number of tags from growing indefinitely and causing performance issues or crashing the server.
If the number of tags exceeds this value, a warning will be logged and no more HTTP server request metrics will be recorded. |
-| `polaris.metrics.user-principal-tag.enable-in-api-metrics` | `false` | `boolean` | Whether to include the User Principal tag in the API request metrics.
Beware that if the cardinality of this tag is too high, it can cause performance issues or even crash the server. |
-| `polaris.metrics.http-server-requests.histogram-slos` | | `list of duration` | Service Level Objective (SLO) boundaries for the HTTP server request duration histogram.
When set, one histogram bucket is published per boundary so backends can compute percentiles (e.g. p95, p99) at the configured durations. |
+| `polaris.metrics.realm-id-tag.enable-in-api-metrics` | `false` | `boolean` | Whether to include the Realm ID tag in the API request metrics.
Beware that if the cardinality of this tag is too high, it can cause performance issues or even crash the server. |
+| `polaris.metrics.realm-id-tag.enable-in-http-metrics` | `false` | `boolean` | Whether to include the Realm ID tag in the HTTP server request metrics.
Beware that if the cardinality of this tag is too high, it can cause performance issues or even crash the server. |
+| `polaris.metrics.realm-id-tag.http-metrics-max-cardinality` | `100` | `int` | The maximum number of Realm ID tag values allowed for the HTTP server request metrics.
This is used to prevent the number of tags from growing indefinitely and causing performance issues or crashing the server.
If the number of tags exceeds this value, a warning will be logged and no more HTTP server request metrics will be recorded. |
+| `polaris.metrics.user-principal-tag.enable-in-api-metrics` | `false` | `boolean` | Whether to include the User Principal tag in the API request metrics.
Beware that if the cardinality of this tag is too high, it can cause performance issues or even crash the server. |
+| `polaris.metrics.http-server-requests.histogram-slos` | | `list of duration` | Service Level Objective (SLO) boundaries for the HTTP server request duration histogram.
When set, one histogram bucket is published per boundary so backends can compute percentiles (e.g. p95, p99) at the configured durations. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_node.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_node.md
index b6a25078213..5e1c65fd66e 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_node.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_node.md
@@ -29,6 +29,6 @@ Node management configuration.
|----------|---------------|------|-------------|
| `polaris.node.lease-duration` | `PT1H` | `duration` | Duration of a node-lease. |
| `polaris.node.renewal-period` | `PT15M` | `duration` | Time window before the end of a node lease when the lease will be renewed. |
-| `polaris.node.num-nodes` | `1024` | `int` | Maximum number of concurrently active Polaris nodes. Do not change this value or the ID generator spec, it is a rather internal property. See ID generator spec below. |
+| `polaris.node.num-nodes` | `1024` | `int` | Maximum number of concurrently active Polaris nodes. Do not change this value or the ID generator spec, it is a rather internal property. See ID generator spec below. |
| `polaris.node.id-generator-spec.type` | `snowflake` | `string` | |
| `polaris.node.id-generator-spec.params.`_``_ | | `string` | |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_oidc.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_oidc.md
index ade96c7abe4..b0baa51c88d 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_oidc.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_oidc.md
@@ -27,20 +27,20 @@ Polaris-specific configuration for OIDC tenants.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.oidc.principal-mapper.id-claim-path` | | `string` | The path to the claim that contains the principal ID. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional. Either this option or (`#nameClaimPath()`) must be provided. |
-| `polaris.oidc.principal-mapper.name-claim-path` | | `string` | The claim that contains the principal name. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional when using internal credential mode, in which case either this option or (`#idClaimPath()`) must be provided.
Required when using external credential mode ( `polaris.authentication.credential-mode=EXTERNAL` ), since external principals are identified exclusively by name. |
-| `polaris.oidc.principal-mapper.type` | `default` | `string` | The type of the principal mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalMapper`) identifier. |
-| `polaris.oidc.principal-roles-mapper.type` | `default` | `string` | The type of the principal roles mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalRolesMapper`) identifier. |
-| `polaris.oidc.principal-roles-mapper.filter` | | `string` | A regular expression that matches the role names in the identity. Only roles that match this regex will be included in the Polaris-specific roles. |
+| `polaris.oidc.principal-mapper.id-claim-path` | | `string` | The path to the claim that contains the principal ID. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional. Either this option or (`#nameClaimPath()`) must be provided. |
+| `polaris.oidc.principal-mapper.name-claim-path` | | `string` | The claim that contains the principal name. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional when using internal credential mode, in which case either this option or (`#idClaimPath()`) must be provided.
Required when using external credential mode (`polaris.authentication.credential-mode=EXTERNAL`), since external principals are identified exclusively by name. |
+| `polaris.oidc.principal-mapper.type` | `default` | `string` | The type of the principal mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalMapper`) identifier. |
+| `polaris.oidc.principal-roles-mapper.type` | `default` | `string` | The type of the principal roles mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalRolesMapper`) identifier. |
+| `polaris.oidc.principal-roles-mapper.filter` | | `string` | A regular expression that matches the role names in the identity. Only roles that match this regex will be included in the Polaris-specific roles. |
| `polaris.oidc.principal-roles-mapper.mappings` | | `list of ` | A list of regex mappings that will be applied to each role name in the identity. |
-| `polaris.oidc.principal-roles-mapper.mappings.regex` | | `string` | A regular expression that will be applied to each role name in the identity. Along with (`#replacement()`), this regex is used to transform the role names in the identity into Polaris-specific roles. |
-| `polaris.oidc.principal-roles-mapper.mappings.replacement` | | `string` | The replacement string for the role names in the identity. This is used along with (`#regex()`) to transform the role names in the identity into Polaris-specific roles. |
-| `polaris.oidc.`_``_`.principal-mapper.id-claim-path` | | `string` | The path to the claim that contains the principal ID. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional. Either this option or (`#nameClaimPath()`) must be provided. |
-| `polaris.oidc.`_``_`.principal-mapper.name-claim-path` | | `string` | The claim that contains the principal name. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional when using internal credential mode, in which case either this option or (`#idClaimPath()`) must be provided.
Required when using external credential mode ( `polaris.authentication.credential-mode=EXTERNAL` ), since external principals are identified exclusively by name. |
-| `polaris.oidc.`_``_`.principal-mapper.type` | `default` | `string` | The type of the principal mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalMapper`) identifier. |
-| `polaris.oidc.`_``_`.principal-roles-mapper.type` | `default` | `string` | The type of the principal roles mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalRolesMapper`) identifier. |
-| `polaris.oidc.`_``_`.principal-roles-mapper.filter` | | `string` | A regular expression that matches the role names in the identity. Only roles that match this regex will be included in the Polaris-specific roles. |
+| `polaris.oidc.principal-roles-mapper.mappings.regex` | | `string` | A regular expression that will be applied to each role name in the identity. Along with (`#replacement()`), this regex is used to transform the role names in the identity into Polaris-specific roles. |
+| `polaris.oidc.principal-roles-mapper.mappings.replacement` | | `string` | The replacement string for the role names in the identity. This is used along with (`#regex()`) to transform the role names in the identity into Polaris-specific roles. |
+| `polaris.oidc.`_``_`.principal-mapper.id-claim-path` | | `string` | The path to the claim that contains the principal ID. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional. Either this option or (`#nameClaimPath()`) must be provided. |
+| `polaris.oidc.`_``_`.principal-mapper.name-claim-path` | | `string` | The claim that contains the principal name. Nested paths can be expressed using "/" as a separator, e.g. `"resource_access/client1/roles"` would look for the "roles" field inside the "client1" object inside the "resource_access" object in the token claims.
Optional when using internal credential mode, in which case either this option or (`#idClaimPath()`) must be provided.
Required when using external credential mode (`polaris.authentication.credential-mode=EXTERNAL`), since external principals are identified exclusively by name. |
+| `polaris.oidc.`_``_`.principal-mapper.type` | `default` | `string` | The type of the principal mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalMapper`) identifier. |
+| `polaris.oidc.`_``_`.principal-roles-mapper.type` | `default` | `string` | The type of the principal roles mapper. Must be a registered (`org.apache.polaris.service.auth.external.mapping.PrincipalRolesMapper`) identifier. |
+| `polaris.oidc.`_``_`.principal-roles-mapper.filter` | | `string` | A regular expression that matches the role names in the identity. Only roles that match this regex will be included in the Polaris-specific roles. |
| `polaris.oidc.`_``_`.principal-roles-mapper.mappings` | | `list of ` | A list of regex mappings that will be applied to each role name in the identity. |
-| `polaris.oidc.`_``_`.principal-roles-mapper.mappings.regex` | | `string` | A regular expression that will be applied to each role name in the identity. Along with (`#replacement()`), this regex is used to transform the role names in the identity into Polaris-specific roles. |
-| `polaris.oidc.`_``_`.principal-roles-mapper.mappings.replacement` | | `string` | The replacement string for the role names in the identity. This is used along with (`#regex()`) to transform the role names in the identity into Polaris-specific roles. |
-| `polaris.oidc.tenant-resolver.type` | `default` | `string` | The type of the OIDC tenant resolver. Must be a registered (`OidcTenantResolver`) implementation. |
+| `polaris.oidc.`_``_`.principal-roles-mapper.mappings.regex` | | `string` | A regular expression that will be applied to each role name in the identity. Along with (`#replacement()`), this regex is used to transform the role names in the identity into Polaris-specific roles. |
+| `polaris.oidc.`_``_`.principal-roles-mapper.mappings.replacement` | | `string` | The replacement string for the role names in the identity. This is used along with (`#regex()`) to transform the role names in the identity into Polaris-specific roles. |
+| `polaris.oidc.tenant-resolver.type` | `default` | `string` | The type of the OIDC tenant resolver. Must be a registered (`OidcTenantResolver`) implementation. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence.md
index fce6e68b257..b166b8000da 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence.md
@@ -25,7 +25,7 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.persistence.type` | | `string` | The type of the persistence to use. Must be a registered (`org.apache.polaris.core.persistence.MetaStoreManagerFactory`) identifier. |
+| `polaris.persistence.type` | | `string` | The type of the persistence to use. Must be a registered (`org.apache.polaris.core.persistence.MetaStoreManagerFactory`) identifier. |
| `polaris.persistence.auto-bootstrap-types` | | `list of string` | |
| `polaris.persistence.reference-previous-head-count` | `20` | `int` | |
| `polaris.persistence.max-index-stripes` | `20` | `int` | |
@@ -33,9 +33,9 @@ build:
| `polaris.persistence.max-index-stripe-size` | `128k` | `MemorySize` | |
| `polaris.persistence.retry.timeout` | `PT15S` | `duration` | Maximum allowed time until a retry-loop and commits (Committer#commit(CommitRetryable)) fails with a (`RetryTimeoutException`), defaults to "PT15S". |
| `polaris.persistence.retry.retries` | `10000` | `int` | Maximum number of allowed retries, defaults to "10000". |
-| `polaris.persistence.retry.initial-sleep-lower` | `PT0.010S` | `duration` | Initial lower bound for a retry-sleep duration for the retry-loop, defaults to (`PT0.010S`). This value will be doubled after each retry, as long as (`#maxSleep()`) is not exceeded. A concrete sleep duration will be randomly chosen between the current lower and upper bounds. |
-| `polaris.persistence.retry.initial-sleep-upper` | `PT0.020S` | `duration` | Initial upper bound for a retry-sleep duration for the retry-loop, defaults to (`PT0.020S`). This value will be doubled after each retry, as long as (`#maxSleep()`) is not exceeded. A concrete sleep duration will be randomly chosen between the current lower and upper bounds. |
+| `polaris.persistence.retry.initial-sleep-lower` | `PT0.010S` | `duration` | Initial lower bound for a retry-sleep duration for the retry-loop, defaults to (`PT0.010S`). This value will be doubled after each retry, as long as (`#maxSleep()`) is not exceeded. A concrete sleep duration will be randomly chosen between the current lower and upper bounds. |
+| `polaris.persistence.retry.initial-sleep-upper` | `PT0.020S` | `duration` | Initial upper bound for a retry-sleep duration for the retry-loop, defaults to (`PT0.020S`). This value will be doubled after each retry, as long as (`#maxSleep()`) is not exceeded. A concrete sleep duration will be randomly chosen between the current lower and upper bounds. |
| `polaris.persistence.retry.max-sleep` | `PT0.250S` | `duration` | Maximum retry-sleep duration, defaults to (`PT0.250S`). |
-| `polaris.persistence.retry.fair-retries` | `SLEEPING` | `enum (UNFAIR, SLEEPING)` | Without mitigation, very frequently started retry-loops running against highly contended resources can result in some retry-loops invocations never making any progress and eventually time out.
The default "fair retries type" helps in these scenarios with sacrificing the overall throughput too much.
Locally synchronized commits use a fair semaphore instead of fairness sleeps; conflict retry backoff still applies. |
+| `polaris.persistence.retry.fair-retries` | `SLEEPING` | `enum (UNFAIR, SLEEPING)` | Without mitigation, very frequently started retry-loops running against highly contended resources can result in some retry-loops invocations never making any progress and eventually time out.
The default "fair retries type" helps in these scenarios with sacrificing the overall throughput too much.
Locally synchronized commits use a fair semaphore instead of fairness sleeps; conflict retry backoff still applies. |
| `polaris.persistence.bucketized-bulk-fetch-size` | `16` | `int` | The number of objects to fetch at once via (`Persistence#bucketizedBulkFetches(Stream,
Class)`). |
| `polaris.persistence.max-serialized-value-size` | `350k` | `MemorySize` | The maximum size of a serialized value in a persisted database row. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_cache.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_cache.md
index 17d1e2af082..e3ce662e013 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_cache.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_cache.md
@@ -27,11 +27,11 @@ Persistence cache configuration.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.persistence.cache.enable` | `true` | `boolean` | Optionally disable the cache, the default value is `true`, meaning that the cache is _enabled_ by default. |
+| `polaris.persistence.cache.enable` | `true` | `boolean` | Optionally disable the cache, the default value is `true`, meaning that the cache is _enabled_ by default. |
| `polaris.persistence.cache.reference-ttl` | `PT15M` | `duration` | Duration to cache the state of references. |
-| `polaris.persistence.cache.reference-negative-ttl` | | `duration` | Duration to cache whether a reference does _not_ exist (negative caching). |
-| `polaris.persistence.cache.sizing.fraction-of-max-heap-size` | | `double` | Fraction of Java’s max heap size to use for cache objects, set to 0 to disable. Must not be used with fixed cache sizing. If neither this value nor a fixed size is configured, a default of `.4` (40%) is assumed, if `enable-soft-references` is enabled, else `.6` (60%) is assumed. |
+| `polaris.persistence.cache.reference-negative-ttl` | | `duration` | Duration to cache whether a reference does _not_ exist (negative caching). |
+| `polaris.persistence.cache.sizing.fraction-of-max-heap-size` | | `double` | Fraction of Java’s max heap size to use for cache objects, set to 0 to disable. Must not be used with fixed cache sizing. If neither this value nor a fixed size is configured, a default of `.4` (40%) is assumed, if `enable-soft-references` is enabled, else `.6` (60%) is assumed. |
| `polaris.persistence.cache.sizing.fraction-min-size` | `64M` | `MemorySize` | When using fractional cache sizing, this amount in MB is the minimum cache size. |
-| `polaris.persistence.cache.sizing.fraction-adjustment` | `256M` | `MemorySize` | When using fractional cache sizing, this amount in MB of the heap will always be "kept free" when calculating the cache size. |
+| `polaris.persistence.cache.sizing.fraction-adjustment` | `256M` | `MemorySize` | When using fractional cache sizing, this amount in MB of the heap will always be "kept free" when calculating the cache size. |
| `polaris.persistence.cache.sizing.fixed-size` | | `MemorySize` | Capacity of the persistence cache in MiB. |
-| `polaris.persistence.cache.sizing.cache-capacity-overshoot` | `0.1` | `double` | Admitted cache-capacity-overshoot fraction, defaults to `0.1` (10 %).
New elements are admitted to be added to the cache, if the cache's size is less than `cache-capacity * (1 + cache-capacity-overshoot` .
Cache eviction happens asynchronously. Situations when eviction cannot keep up with the amount of data added could lead to out-of-memory situations.
The value, if present, must be greater than 0. |
+| `polaris.persistence.cache.sizing.cache-capacity-overshoot` | `0.1` | `double` | Admitted cache-capacity-overshoot fraction, defaults to `0.1` (10 %).
New elements are admitted to be added to the cache, if the cache's size is less than `cache-capacity * (1 + cache-capacity-overshoot`.
Cache eviction happens asynchronously. Situations when eviction cannot keep up with the amount of data added could lead to out-of-memory situations.
The value, if present, must be greater than 0. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_distributed_cache_invalidations.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_distributed_cache_invalidations.md
index a3a75d4002d..bd46a2deb12 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_distributed_cache_invalidations.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_distributed_cache_invalidations.md
@@ -25,11 +25,11 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.persistence.distributed-cache-invalidations.service-names` | | `list of string` | Host names, IP addresses, or Kubernetes headless-service name of all Polaris server instances accessing the same repository, used by the default DNS peer discovery implementation.
This value is not configured automatically. For a multi-instance deployment, configure peer discovery; for the default DNS implementation set the host names, IP addresses, or the Kubernetes headless-service name of all Polaris instances here. Cache invalidations are only sent between instances when both peer discovery and `valid-tokens` are configured.
Names that start with an equal sign are not resolved but used "as is". |
+| `polaris.persistence.distributed-cache-invalidations.service-names` | | `list of string` | Host names, IP addresses, or Kubernetes headless-service name of all Polaris server instances accessing the same repository, used by the default DNS peer discovery implementation.
This value is not configured automatically. For a multi-instance deployment, configure peer discovery; for the default DNS implementation set the host names, IP addresses, or the Kubernetes headless-service name of all Polaris instances here. Cache invalidations are only sent between instances when both peer discovery and `valid-tokens` are configured.
Names that start with an equal sign are not resolved but used "as is". |
| `polaris.persistence.distributed-cache-invalidations.valid-tokens` | | `list of string` | List of cache-invalidation tokens to authenticate incoming cache-invalidation messages.
The first token is used in outgoing cache-invalidation messages. |
-| `polaris.persistence.distributed-cache-invalidations.uri` | `/polaris-management/cache-coherency` | `string` | URI of the cache-invalidation endpoint, only available on the Quarkus management port, defaults to 9000. |
+| `polaris.persistence.distributed-cache-invalidations.uri` | `/polaris-management/cache-coherency` | `string` | URI of the cache-invalidation endpoint, only available on the Quarkus management port, defaults to 9000. |
| `polaris.persistence.distributed-cache-invalidations.service-name-lookup-interval` | `PT10S` | `duration` | Interval between peer discovery refreshes. |
-| `polaris.persistence.distributed-cache-invalidations.initial-discovery-required` | `true` | `boolean` | Whether startup fails when the initial peer discovery request fails.
A successful empty peer snapshot does not fail startup. When disabled, discovery failures are retried in the background. |
+| `polaris.persistence.distributed-cache-invalidations.initial-discovery-required` | `true` | `boolean` | Whether startup fails when the initial peer discovery request fails.
A successful empty peer snapshot does not fail startup. When disabled, discovery failures are retried in the background. |
| `polaris.persistence.distributed-cache-invalidations.batch-size` | `20` | `int` | Maximum number of cache-invalidation messages to send in a single request to peer nodes. |
-| `polaris.persistence.distributed-cache-invalidations.request-timeout` | | `duration` | Request timeout for sent cache-invalidation messages. Timeouts trigger a warning or error message. |
+| `polaris.persistence.distributed-cache-invalidations.request-timeout` | | `duration` | Request timeout for sent cache-invalidation messages. Timeouts trigger a warning or error message. |
| `polaris.persistence.distributed-cache-invalidations.dns.query-timeout` | `PT5S` | `duration` | Timeout for DNS queries performed by the default peer discovery implementation. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance.md
index f60988fe534..fd834e7e266 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance.md
@@ -27,13 +27,13 @@ Maintenance service configuration.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.persistence.nosql.maintenance.expected-reference-count` | `100` | `long` | Provides the expected number of references in all realms to retain, defaults to 100, must be at least `100`. This value is used as the default if no information of a previous maintenance run is present, it is also the minimum number of expected references. |
-| `polaris.persistence.nosql.maintenance.expected-obj-count` | `100000` | `long` | Provides the expected number of objects in all realms to retain, defaults to 100000, must be at least `100000`. This value is used as the default if no information of a previous maintenance run is present, it is also the minimum number of expected objects. |
-| `polaris.persistence.nosql.maintenance.count-from-last-run-multiplier` | `1.1` | `double` | Maintenance service sizes the bloom-filters used to hold the identified references and objects according to the expression `lastRun.numberOfIdentified * countFromLastRunMultiplier`. The default is to add 10% to the number of identified items. |
-| `polaris.persistence.nosql.maintenance.filter-initialized-fpp` | `1.0E-5` | `double` | False-positive-probability (FPP) used to initialize the bloom-filters for identified references and objects. |
-| `polaris.persistence.nosql.maintenance.max-acceptable-filter-fpp` | `5.0E-5` | `double` | Expected maximum false-positive-probability (FPP) used to check the bloom-filters for identified references and objects.
If the FPP of a bloom filter exceeds this value, no individual references or objects will be purged. |
-| `polaris.persistence.nosql.maintenance.retained-runs` | `50` | `int` | Number of retained maintenance run objects (MaintenanceRunInformation), must be at least `2`. |
-| `polaris.persistence.nosql.maintenance.created-at-grace-time` | `PT3H` | `duration` | Objects and references that have been created _after_ a maintenance run has started are never purged. This option defines an additional grace time to when the maintenance run has started.
This value is a safety net for two reasons:
* Respect the wall-clock drift between Polaris nodes.
* Respect the order of writes in Polaris persistence. Objects are written _before_ those become reachable via a commit. Commits may take a little time (milliseconds, up to a few seconds, depending on the system load) to complete. Therefore, implementations enforce a minimum of 5 minutes.
|
-| `polaris.persistence.nosql.maintenance.object-scan-rate-limit-per-second` | | `int` | Optionally limit the number of object parts scanned or fetched during retained-object identification per second, including non-recording cleanup reads. The limit is shared across realms during identification. Default is unlimited. Large fetch batches may cause temporary bursts. |
-| `polaris.persistence.nosql.maintenance.reference-scan-rate-limit-per-second` | | `int` | Optionally limit the number of references scanned or fetched during retained-object identification per second, including non-recording cleanup reads. The limit is shared across realms during identification. Default is unlimited. |
+| `polaris.persistence.nosql.maintenance.expected-reference-count` | `100` | `long` | Provides the expected number of references in all realms to retain, defaults to 100, must be at least `100`. This value is used as the default if no information of a previous maintenance run is present, it is also the minimum number of expected references. |
+| `polaris.persistence.nosql.maintenance.expected-obj-count` | `100000` | `long` | Provides the expected number of objects in all realms to retain, defaults to 100000, must be at least `100000`. This value is used as the default if no information of a previous maintenance run is present, it is also the minimum number of expected objects. |
+| `polaris.persistence.nosql.maintenance.count-from-last-run-multiplier` | `1.1` | `double` | Maintenance service sizes the bloom-filters used to hold the identified references and objects according to the expression `lastRun.numberOfIdentified * countFromLastRunMultiplier`. The default is to add 10% to the number of identified items. |
+| `polaris.persistence.nosql.maintenance.filter-initialized-fpp` | `1.0E-5` | `double` | False-positive-probability (FPP) used to initialize the bloom-filters for identified references and objects. |
+| `polaris.persistence.nosql.maintenance.max-acceptable-filter-fpp` | `5.0E-5` | `double` | Expected maximum false-positive-probability (FPP) used to check the bloom-filters for identified references and objects.
If the FPP of a bloom filter exceeds this value, no individual references or objects will be purged. |
+| `polaris.persistence.nosql.maintenance.retained-runs` | `50` | `int` | Number of retained maintenance run objects (MaintenanceRunInformation), must be at least `2`. |
+| `polaris.persistence.nosql.maintenance.created-at-grace-time` | `PT3H` | `duration` | Objects and references that have been created _after_ a maintenance run has started are never purged. This option defines an additional grace time to when the maintenance run has started.
This value is a safety net for two reasons:
* Respect the wall-clock drift between Polaris nodes.
* Respect the order of writes in Polaris persistence. Objects are written _before_ those become reachable via a commit. Commits may take a little time (milliseconds, up to a few seconds, depending on the system load) to complete. Therefore, implementations enforce a minimum of 5 minutes.
|
+| `polaris.persistence.nosql.maintenance.object-scan-rate-limit-per-second` | | `int` | Optionally limit the number of object parts scanned or fetched during retained-object identification per second, including non-recording cleanup reads. The limit is shared across realms during identification. Default is unlimited. Large fetch batches may cause temporary bursts. |
+| `polaris.persistence.nosql.maintenance.reference-scan-rate-limit-per-second` | | `int` | Optionally limit the number of references scanned or fetched during retained-object identification per second, including non-recording cleanup reads. The limit is shared across realms during identification. Default is unlimited. |
| `polaris.persistence.nosql.maintenance.delete-batch-size` | `10` | `int` | Size of the delete-batches when purging objects. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance_catalog.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance_catalog.md
index e070e27fba9..e2a79f73772 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance_catalog.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_persistence_nosql_maintenance_catalog.md
@@ -23,24 +23,24 @@ build:
render: never
---
-No SQL persistence implementation of Polaris stores a history of changes per kind of object (principals, principal roles, grants, immediate tasks, catalog roles and catalog state).
+No SQL persistence implementation of Polaris stores a history of changes per kind of object (principals, principal roles, grants, immediate tasks, catalog roles and catalog state).
-The rules are defined using a [CEL script ](https://github.com/projectnessie/cel-java/). The default rules for all kinds of objects are to retain the history for 3 days, for the catalog state for 30 days.
+The rules are defined using a [CEL script](https://github.com/projectnessie/cel-java/). The default rules for all kinds of objects are to retain the history for 3 days, for the catalog state for 30 days.
-The scripts have access to the following declared values:
+The scripts have access to the following declared values:
- * `ref` (string) name of the reference
+ * `ref` (string) name of the reference
* `commits` (64-bit int) number of the currently processed commit, starting at `1`
- * `ageDays` (64-bit int) age of currently processed commit in days
- * `ageHours` (64-bit int) age of currently processed commit in hours
- * `ageMinutes` (64-bit int) age of currently processed commit in minutes
+ * `ageDays` (64-bit int) age of currently processed commit in days
+ * `ageHours` (64-bit int) age of currently processed commit in hours
+ * `ageMinutes` (64-bit int) age of currently processed commit in minutes
-Scripts _must_ return a `boolean` yielding whether the commit shall be retained. Note that maintenance-service implementations can keep the first not-to-be-retained commit.
+Scripts _must_ return a `boolean` yielding whether the commit shall be retained. Note that maintenance-service implementations can keep the first not-to-be-retained commit.
-Example scripts
+Example scripts
- * `ageDays < 30 || commits <= 10` retains the reference history with at least 10 commits and commits that are younger than 30 days
- * `true` retains the whole reference history
+ * `ageDays < 30 || commits <= 10` retains the reference history with at least 10 commits and commits that are younger than 30 days
+ * `true` retains the whole reference history
* `false` retains the most recent commit
| Property | Default Value | Type | Description |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_filter.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_filter.md
index 4f3fb14a639..405fdb4701c 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_filter.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_filter.md
@@ -25,4 +25,4 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.rate-limiter.filter.type` | | `string` | The type of the rate limiter. Must be a registered (`org.apache.polaris.service.ratelimiter.RateLimiter`) identifier. |
+| `polaris.rate-limiter.filter.type` | | `string` | The type of the rate limiter. Must be a registered (`org.apache.polaris.service.ratelimiter.RateLimiter`) identifier. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_token_bucket.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_token_bucket.md
index ca14f283596..b1ee215adc0 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_token_bucket.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_rate_limiter_token_bucket.md
@@ -25,6 +25,6 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.rate-limiter.token-bucket.requests-per-second` | | `long` | Number of allowed requests per second per realm. The value _must_ be greater than zero. |
+| `polaris.rate-limiter.token-bucket.requests-per-second` | | `long` | Number of allowed requests per second per realm. The value _must_ be greater than zero. |
| `polaris.rate-limiter.token-bucket.window` | | `duration` | This setting is no longer used and will be removed in a future release.
_Deprecated_ |
-| `polaris.rate-limiter.token-bucket.type` | | `string` | The type of the token bucket factory. Must be a registered (`org.apache.polaris.service.ratelimiter.TokenBucketFactory`) identifier. |
+| `polaris.rate-limiter.token-bucket.type` | | `string` | The type of the token bucket factory. Must be a registered (`org.apache.polaris.service.ratelimiter.TokenBucketFactory`) identifier. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_readiness.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_readiness.md
index 476f9ab8996..776e6b541eb 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_readiness.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_readiness.md
@@ -25,4 +25,4 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.readiness.ignore-severe-issues` | `false` | `boolean` | Setting this to `true` means that Polaris will start up even if severe security risks have been detected, accepting the risk of denial-of-service, data-loss, corruption and other risks. |
+| `polaris.readiness.ignore-severe-issues` | `false` | `boolean` | Setting this to `true` means that Polaris will start up even if severe security risks have been detected, accepting the risk of denial-of-service, data-loss, corruption and other risks. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_realm_context.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_realm_context.md
index 133892c58c4..55402f987ab 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_realm_context.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_realm_context.md
@@ -25,7 +25,7 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.realm-context.realms` | | `list of string` | The set of realms that are supported by the realm context resolver. The first realm is considered the default realm. |
+| `polaris.realm-context.realms` | | `list of string` | The set of realms that are supported by the realm context resolver. The first realm is considered the default realm. |
| `polaris.realm-context.header-name` | | `string` | The header name that contains the realm identifier. |
-| `polaris.realm-context.require-header` | | `boolean` | Whether to require the realm header to be present in the request. If this is true and the realm header is not present, the request will be rejected. If this is false and the realm header is not present, the default realm will be used.
Note: this is actually only enforced in production setups. |
-| `polaris.realm-context.type` | | `string` | The type of the realm context resolver. Must be a registered (`org.apache.polaris.service.context.RealmContextResolver`) identifier. |
+| `polaris.realm-context.require-header` | | `boolean` | Whether to require the realm header to be present in the request. If this is true and the realm header is not present, the request will be rejected. If this is false and the realm header is not present, the default realm will be used.
Note: this is actually only enforced in production setups. |
+| `polaris.realm-context.type` | | `string` | The type of the realm context resolver. Must be a registered (`org.apache.polaris.service.context.RealmContextResolver`) identifier. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_reserved_properties.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_reserved_properties.md
index 98a9c4ee429..d34fd67cdae 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_reserved_properties.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_reserved_properties.md
@@ -23,5 +23,5 @@ build:
render: never
---
-Used to track entity properties reserved for use by the catalog. These properties may not be overridden by the end user.
+Used to track entity properties reserved for use by the catalog. These properties may not be overridden by the end user.
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_secrets_manager.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_secrets_manager.md
index 04b6503b432..0f8664faba3 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_secrets_manager.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_secrets_manager.md
@@ -25,4 +25,4 @@ build:
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.secrets-manager.type` | | `string` | The type of the UserSecretsManagerFactory to use. This is the (`org.apache.polaris.core.secrets.UserSecretsManagerFactory`) identifier. |
+| `polaris.secrets-manager.type` | | `string` | The type of the UserSecretsManagerFactory to use. This is the (`org.apache.polaris.core.secrets.UserSecretsManagerFactory`) identifier. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_service_identity.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_service_identity.md
index 3d2c607292e..faf90946670 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_service_identity.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_service_identity.md
@@ -25,11 +25,11 @@ build:
Configuration interface for managing service identities across multiple realms in Polaris.
-A service identity represents the Polaris service itself when it needs to authenticate to external systems (e.g., AWS services for SigV4 authentication). Each realm can configure its own set of service identities for different cloud providers.
+A service identity represents the Polaris service itself when it needs to authenticate to external systems (e.g., AWS services for SigV4 authentication). Each realm can configure its own set of service identities for different cloud providers.
-This interface supports multi-tenant deployments where each realm (tenant) can have distinct service identities, as well as single-tenant deployments with a default configuration shared across all catalogs.
+This interface supports multi-tenant deployments where each realm (tenant) can have distinct service identities, as well as single-tenant deployments with a default configuration shared across all catalogs.
-Configuration is loaded from `polaris.service-identity.*` properties at startup and includes credentials that Polaris uses to assume customer-provided roles when accessing federated catalogs.
+Configuration is loaded from `polaris.service-identity.*` properties at startup and includes credentials that Polaris uses to assume customer-provided roles when accessing federated catalogs.
**Example Configuration:**
@@ -48,11 +48,11 @@ Configuration is loaded from `polaris.service-identity.*` properties at startup
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.service-identity.aws-iam.iam-arn` | | `string` | The IAM role or user ARN representing the service identity. If not provided, Polaris won't surface it in the catalog identity. |
-| `polaris.service-identity.aws-iam.access-key-id` | | `string` | Optional AWS access key ID associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
-| `polaris.service-identity.aws-iam.secret-access-key` | | `string` | Optional AWS secret access key associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
-| `polaris.service-identity.aws-iam.session-token` | | `string` | Optional AWS session token associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
-| `polaris.service-identity.`_``_`.aws-iam.iam-arn` | | `string` | The IAM role or user ARN representing the service identity. If not provided, Polaris won't surface it in the catalog identity. |
-| `polaris.service-identity.`_``_`.aws-iam.access-key-id` | | `string` | Optional AWS access key ID associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
-| `polaris.service-identity.`_``_`.aws-iam.secret-access-key` | | `string` | Optional AWS secret access key associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
-| `polaris.service-identity.`_``_`.aws-iam.session-token` | | `string` | Optional AWS session token associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
+| `polaris.service-identity.aws-iam.iam-arn` | | `string` | The IAM role or user ARN representing the service identity. If not provided, Polaris won't surface it in the catalog identity. |
+| `polaris.service-identity.aws-iam.access-key-id` | | `string` | Optional AWS access key ID associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
+| `polaris.service-identity.aws-iam.secret-access-key` | | `string` | Optional AWS secret access key associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
+| `polaris.service-identity.aws-iam.session-token` | | `string` | Optional AWS session token associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
+| `polaris.service-identity.`_``_`.aws-iam.iam-arn` | | `string` | The IAM role or user ARN representing the service identity. If not provided, Polaris won't surface it in the catalog identity. |
+| `polaris.service-identity.`_``_`.aws-iam.access-key-id` | | `string` | Optional AWS access key ID associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
+| `polaris.service-identity.`_``_`.aws-iam.secret-access-key` | | `string` | Optional AWS secret access key associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
+| `polaris.service-identity.`_``_`.aws-iam.session-token` | | `string` | Optional AWS session token associated with the IAM identity. If not provided, the AWS default credential chain will be used. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage.md
index d9a6edf3e42..43c73c36544 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage.md
@@ -23,24 +23,24 @@ build:
render: never
---
-Configuration interface containing parameters for clients accessing S3 services from Polaris servers.
+Configuration interface containing parameters for clients accessing S3 services from Polaris servers.
-Applies to the STS client pool and to Iceberg S3 clients created for table operations via `S3FileIO`.
+Applies to the STS client pool and to Iceberg S3 clients created for table operations via `S3FileIO`.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.storage.aws.access-key` | | `string` | The AWS access key to use for authentication. If not present, the default credentials provider chain will be used. |
-| `polaris.storage.aws.secret-key` | | `string` | The AWS secret key to use for authentication. If not present, the default credentials provider chain will be used. |
+| `polaris.storage.aws.access-key` | | `string` | The AWS access key to use for authentication. If not present, the default credentials provider chain will be used. |
+| `polaris.storage.aws.secret-key` | | `string` | The AWS secret key to use for authentication. If not present, the default credentials provider chain will be used. |
| `polaris.storage.aws.`_``_`.access-key` | | `string` | The AWS access key to use for authentication when using named storages. |
| `polaris.storage.aws.`_``_`.secret-key` | | `string` | The AWS secret key to use for authentication when using named storages. |
-| `polaris.storage.gcp.token` | | `string` | The GCP access token to use for authentication. If not present, the default credentials provider chain will be used. |
-| `polaris.storage.gcp.lifespan` | | `duration` | How far in the future the configured GCP access token's expiry is stamped. The expiry is computed once, when the credential is created, and is returned unchanged on every refresh. If not present, the default token lifespan (null) is used. Ignored when (`#gcpAccessTokenExpiry()`) is set. This does not extend the token's real validity on the provider side; it only controls the expiry Polaris reports for the configured token. |
-| `polaris.storage.gcp.expiry` | | `instant` | A fixed expiry for the configured GCP access token, as an ISO-8601 instant (for example `2027-01-01T00:00:00Z` ). When present, this exact instant is reported as the token's expiry and is returned unchanged on every refresh, and (`#gcpAccessTokenLifespan()`) is ignored. When absent, the expiry is computed from the lifespan. Like the lifespan, this does not extend the token's real validity on the provider side; it only controls the expiry Polaris reports for the configured token. |
+| `polaris.storage.gcp.token` | | `string` | The GCP access token to use for authentication. If not present, the default credentials provider chain will be used. |
+| `polaris.storage.gcp.lifespan` | | `duration` | How far in the future the configured GCP access token's expiry is stamped. The expiry is computed once, when the credential is created, and is returned unchanged on every refresh. If not present, the default token lifespan (null) is used. Ignored when (`#gcpAccessTokenExpiry()`) is set. This does not extend the token's real validity on the provider side; it only controls the expiry Polaris reports for the configured token. |
+| `polaris.storage.gcp.expiry` | | `instant` | A fixed expiry for the configured GCP access token, as an ISO-8601 instant (for example `2027-01-01T00:00:00Z`). When present, this exact instant is reported as the token's expiry and is returned unchanged on every refresh, and (`#gcpAccessTokenLifespan()`) is ignored. When absent, the expiry is computed from the lifespan. Like the lifespan, this does not extend the token's real validity on the provider side; it only controls the expiry Polaris reports for the configured token. |
| `polaris.storage.clients-cache-max-size` | | `int` | Maximum number of entries to keep in the STS clients cache. |
| `polaris.storage.max-http-connections` | | `int` | Override the default maximum number of pooled connections. |
| `polaris.storage.read-timeout` | | `duration` | Override the default connection read timeout. |
| `polaris.storage.connect-timeout` | | `duration` | Override the default TCP connect timeout. |
-| `polaris.storage.connection-acquisition-timeout` | | `duration` | Override default connection acquisition timeout. This is the time a request will wait for a connection from the pool. |
+| `polaris.storage.connection-acquisition-timeout` | | `duration` | Override default connection acquisition timeout. This is the time a request will wait for a connection from the pool. |
| `polaris.storage.connection-max-idle-time` | | `duration` | Override default max idle time of a pooled connection. |
| `polaris.storage.connection-time-to-live` | | `duration` | Override default time-to-live of a pooled connection. |
| `polaris.storage.expect-continue-enabled` | | `boolean` | Override default behavior whether to expect an HTTP/100-Continue. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage_cloudflare_r2.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage_cloudflare_r2.md
index e16ff01e4b8..df72425d0e7 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage_cloudflare_r2.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_storage_cloudflare_r2.md
@@ -23,29 +23,29 @@ build:
render: never
---
-Cloudflare R2 parent API tokens. The `R2_LOCAL_SIGNING` credential vending mechanism signs temporary credentials for S3 catalogs from one of these tokens.
+Cloudflare R2 parent API tokens. The `R2_LOCAL_SIGNING` credential vending mechanism signs temporary credentials for S3 catalogs from one of these tokens.
-The realm feature `RESOLVE_CREDENTIALS_BY_STORAGE_NAME` selects the token. When it is false (the default), every R2 catalog uses the default `access-key` and `secret-key`, and the catalog's `storageName` is ignored. When it is true, a catalog without a `storageName` uses the default token, and a catalog with a `storageName` uses `polaris.storage.cloudflare-r2..*` . A name without a configured token is refused.
+The realm feature `RESOLVE_CREDENTIALS_BY_STORAGE_NAME` selects the token. When it is false (the default), every R2 catalog uses the default `access-key` and `secret-key`, and the catalog's `storageName` is ignored. When it is true, a catalog without a `storageName` uses the default token, and a catalog with a `storageName` uses `polaris.storage.cloudflare-r2..*`. A name without a configured token is refused.
-A named token needs both `access-key` and `secret-key`, so a name with only one of them fails the server start.
+A named token needs both `access-key` and `secret-key`, so a name with only one of them fails the server start.
-A named token set through environment variables gets its storage name in lower case: `POLARIS_STORAGE_CLOUDFLARE_R2_PROD_ACCESS_KEY` sets the access key for the storage name `prod` . Use environment variables only for a storage name of lower-case letters and digits with no separator. The server silently ignores a variable such as `POLARIS_STORAGE_CLOUDFLARE_R2_TEAM_A_ACCESS_KEY` , so no storage name gets that token. Set the token for any other name in `application.properties` or as a `-D` system property. Quote a name that holds a dot: `polaris.storage.cloudflare-r2."prod.eu".access-key`. Without the quotes, the server start fails.
+A named token set through environment variables gets its storage name in lower case: `POLARIS_STORAGE_CLOUDFLARE_R2_PROD_ACCESS_KEY` sets the access key for the storage name `prod`. Use environment variables only for a storage name of lower-case letters and digits with no separator. The server silently ignores a variable such as `POLARIS_STORAGE_CLOUDFLARE_R2_TEAM_A_ACCESS_KEY`, so no storage name gets that token. Set the token for any other name in `application.properties` or as a `-D` system property. Quote a name that holds a dot: `polaris.storage.cloudflare-r2."prod.eu".access-key`. Without the quotes, the server start fails.
-There is no ambient credential chain for R2, so a catalog without a configured token cannot vend credentials. The secret keys exist only in this server configuration. Catalog storage configs carry no secret. An R2 catalog sets an S3 endpoint, so the realm feature `ALLOW_SETTING_S3_ENDPOINTS` must stay true (the default).
+There is no ambient credential chain for R2, so a catalog without a configured token cannot vend credentials. The secret keys exist only in this server configuration. Catalog storage configs carry no secret. An R2 catalog sets an S3 endpoint, so the realm feature `ALLOW_SETTING_S3_ENDPOINTS` must stay true (the default).
-A vended credential has these limits:
+A vended credential has these limits:
- * A read-write credential can also delete and list objects within its prefixes.
- * A table at the bucket root gets a credential for the whole bucket.
- * A credential stays valid until it expires, and only revoking the parent token ends it early.
- * The tokens are server-wide: every realm that allows `R2_LOCAL_SIGNING` uses them.
- * Whoever can create or update a catalog (`CATALOG_CREATE` or `CATALOG_WRITE_PROPERTIES` ) chooses the buckets, the endpoint, and the storage name within the parent token's reach, so the parent token should cover only the buckets the realm needs.
+ * A read-write credential can also delete and list objects within its prefixes.
+ * A table at the bucket root gets a credential for the whole bucket.
+ * A credential stays valid until it expires, and only revoking the parent token ends it early.
+ * The tokens are server-wide: every realm that allows `R2_LOCAL_SIGNING` uses them.
+ * Whoever can create or update a catalog (`CATALOG_CREATE` or `CATALOG_WRITE_PROPERTIES`) chooses the buckets, the endpoint, and the storage name within the parent token's reach, so the parent token should cover only the buckets the realm needs.
-While `quarkus.config.mapping.validate-unknown` is true (the default), a server build without this extension aborts at startup with `SRCFG00050` on a `polaris.storage.cloudflare-r2.*` system property.
+While `quarkus.config.mapping.validate-unknown` is true (the default), a server build without this extension aborts at startup with `SRCFG00050` on a `polaris.storage.cloudflare-r2.*` system property.
| Property | Default Value | Type | Description |
|----------|---------------|------|-------------|
-| `polaris.storage.cloudflare-r2.access-key` | | `string` | Access key id of the default Cloudflare R2 parent API token. The parent token must carry Object Read and Write permission on every bucket the catalogs use; a temporary credential cannot exceed it. The default token counts as set only when both `access-key` and `secret-key` are set. |
+| `polaris.storage.cloudflare-r2.access-key` | | `string` | Access key id of the default Cloudflare R2 parent API token. The parent token must carry Object Read and Write permission on every bucket the catalogs use; a temporary credential cannot exceed it. The default token counts as set only when both `access-key` and `secret-key` are set. |
| `polaris.storage.cloudflare-r2.secret-key` | | `string` | Secret access key of the default Cloudflare R2 parent API token. |
-| `polaris.storage.cloudflare-r2.`_``_`.access-key` | | `string` | Access key id of the Cloudflare R2 parent API token for catalogs with this `storageName` . The parent token must carry Object Read and Write permission on every bucket those catalogs use; a temporary credential cannot exceed it. |
-| `polaris.storage.cloudflare-r2.`_``_`.secret-key` | | `string` | Secret access key of the Cloudflare R2 parent API token for catalogs with this `storageName` . |
+| `polaris.storage.cloudflare-r2.`_``_`.access-key` | | `string` | Access key id of the Cloudflare R2 parent API token for catalogs with this `storageName`. The parent token must carry Object Read and Write permission on every bucket those catalogs use; a temporary credential cannot exceed it. |
+| `polaris.storage.cloudflare-r2.`_``_`.secret-key` | | `string` | Secret access key of the Cloudflare R2 parent API token for catalogs with this `storageName`. |
diff --git a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_tasks.md b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_tasks.md
index bac1a450831..7170ea03925 100644
--- a/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_tasks.md
+++ b/site/content/in-dev/unreleased/configuration/config-sections/smallrye-polaris_tasks.md
@@ -27,4 +27,4 @@ build:
|----------|---------------|------|-------------|
| `polaris.tasks.max-concurrent-tasks` | `-1` | `int` | |
| `polaris.tasks.max-queued-tasks` | `-1` | `int` | |
-| `polaris.tasks.file-deletion-timeout` | `PT1H` | `duration` | Maximum time a file-cleanup task will wait for its asynchronous object-store deletions to complete before giving up and failing the task (which then follows the normal retry path). This bounds the task-executor thread so that a stalled storage endpoint cannot pin it indefinitely. A zero or negative value disables the deadline and waits indefinitely. |
+| `polaris.tasks.file-deletion-timeout` | `PT1H` | `duration` | Maximum time a file-cleanup task will wait for its asynchronous object-store deletions to complete before giving up and failing the task (which then follows the normal retry path). This bounds the task-executor thread so that a stalled storage endpoint cannot pin it indefinitely. A zero or negative value disables the deadline and waits indefinitely. |
diff --git a/tools/config-docs/generator/src/main/java/org/apache/polaris/docs/generator/MarkdownFormatter.java b/tools/config-docs/generator/src/main/java/org/apache/polaris/docs/generator/MarkdownFormatter.java
index 1b6c95571f4..6c047c698bd 100644
--- a/tools/config-docs/generator/src/main/java/org/apache/polaris/docs/generator/MarkdownFormatter.java
+++ b/tools/config-docs/generator/src/main/java/org/apache/polaris/docs/generator/MarkdownFormatter.java
@@ -241,7 +241,8 @@ void addText(String text) {
}
void addTextOrCode(String text, boolean code) {
- var t = text.replaceAll("\n", " ");
+ // A line break and the indentation around it become one space.
+ var t = text.replaceAll("\\s*\n\\s*", " ");
t = t.replaceFirst("^\\s*", "");
if (t.isEmpty() && !text.isEmpty()) {
@@ -249,9 +250,8 @@ void addTextOrCode(String text, boolean code) {
return;
}
- var e = text.replaceFirst("\\s*$", "");
-
- if (text.charAt(0) != t.charAt(0)) {
+ // A code body that starts on the next line begins with whitespace, which is not a word break.
+ if (!code && text.charAt(0) != t.charAt(0)) {
maybeAddSeparator();
}
@@ -262,10 +262,6 @@ void addTextOrCode(String text, boolean code) {
if (code) {
this.text.append('`');
}
-
- if (!e.equals(t)) {
- maybeAddSeparator();
- }
}
void addCode(String text) {
diff --git a/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestDocGenTool.java b/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestDocGenTool.java
index 96e72994447..d20d74041b6 100644
--- a/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestDocGenTool.java
+++ b/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestDocGenTool.java
@@ -54,7 +54,7 @@ public void docGenTool(@TempDir Path dir) throws Exception {
"""
| Property | Description |
|----------|-------------|
- | `property.one` | A property. "111" is the default value.
Some text there. |
+ | `property.one` | A property. "111" is the default value.
Some text there. |
| `property.four` | Four. |
""");
soft.assertThat(filePropsA)
@@ -64,7 +64,7 @@ public void docGenTool(@TempDir Path dir) throws Exception {
"""
| Property | Description |
|----------|-------------|
- | `property.three` | Some (`value two`) more (`one two three`).
* foo
* bar
* baz
blah
* FOO
* BAR
* BAZ
* foo
* bar
* baz
|
+ | `property.three` | Some (`value two`) more (`one two three`).
* foo
* bar
* baz
blah
* FOO
* BAR
* BAZ
* foo
* bar
* baz
|
""");
soft.assertThat(filePropsB)
.isRegularFile()
@@ -73,7 +73,7 @@ public void docGenTool(@TempDir Path dir) throws Exception {
"""
| Property | Description |
|----------|-------------|
- | `property.two` | Some summary for checkstyle.
Another property, need some words to cause a line break in the value tag here "111" for testing.
Some text there.
_Deprecated_ this is deprecated because of (`property.three`). |
+ | `property.two` | Some summary for checkstyle.
Another property, need some words to cause a line break in the value tag here "111" for testing.
Some text there.
_Deprecated_ this is deprecated because of (`property.three`). |
| `property.five` | Five. |
""");
@@ -89,14 +89,14 @@ public void docGenTool(@TempDir Path dir) throws Exception {
"""
The docs for `my.prefix`.\s
- * Some \s
- * unordered \s
- * list \s
+ * Some\s
+ * unordered\s
+ * list\s
- Some more text. \s
+ Some more text.\s
- 1. one \s
- 1. two \s
+ 1. one\s
+ 1. two\s
1. three
| Property | Default Value | Type | Description |
@@ -105,7 +105,7 @@ public void docGenTool(@TempDir Path dir) throws Exception {
| `my.prefix.some-duration` | | `duration` | A duration of something. |
| `my.prefix.nested.other-int` | | `int` | |
| `my.prefix.nested.boxed-double` | | `double` |
_Deprecated_ |
- | `my.prefix.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]= {"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]= {"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
+ | `my.prefix.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]={"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]={"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
| `my.prefix.some-int-thing` | | `int` | Something int-ish. |
""");
soft.assertThat(fileMyTypes)
@@ -156,19 +156,19 @@ public void docGenTool(@TempDir Path dir) throws Exception {
| `my.types.mapped-a.some-duration` | | `duration` | A duration of something. |
| `my.types.mapped-a.nested.other-int` | | `int` | |
| `my.types.mapped-a.nested.boxed-double` | | `double` |
_Deprecated_ |
- | `my.types.mapped-a.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]= {"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]= {"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
+ | `my.types.mapped-a.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]={"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]={"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
| `my.types.mapped-a.some-int-thing` | | `int` | Something int-ish. |
| `my.types.optional-mapped-a.some-weird-name` | `some-default` | `string` | Something that configures something. |
| `my.types.optional-mapped-a.some-duration` | | `duration` | A duration of something. |
| `my.types.optional-mapped-a.nested.other-int` | | `int` | |
| `my.types.optional-mapped-a.nested.boxed-double` | | `double` |
_Deprecated_ |
- | `my.types.optional-mapped-a.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]= {"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]= {"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
+ | `my.types.optional-mapped-a.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]={"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]={"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
| `my.types.optional-mapped-a.some-int-thing` | | `int` | Something int-ish. |
| `my.types.map-string-mapped-a.`_``_`.some-weird-name` | `some-default` | `string` | Something that configures something. |
| `my.types.map-string-mapped-a.`_``_`.some-duration` | | `duration` | A duration of something. |
| `my.types.map-string-mapped-a.`_``_`.nested.other-int` | | `int` | |
| `my.types.map-string-mapped-a.`_``_`.nested.boxed-double` | | `double` |
_Deprecated_ |
- | `my.types.map-string-mapped-a.`_``_`.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]= {"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]= {"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
+ | `my.types.map-string-mapped-a.`_``_`.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]={"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]={"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
| `my.types.map-string-mapped-a.`_``_`.some-int-thing` | | `int` | Something int-ish. |
| `my.types.some-duration` | | `duration` | A duration of something. |
| `my.types.config-option-foo` | | `string` | Something that configures something. |
@@ -217,7 +217,7 @@ public void docGenTool(@TempDir Path dir) throws Exception {
| `my.types.map.py.`_``_`.some-duration` | | `duration` | A duration of something. |
| `my.types.map.py.`_``_`.nested.other-int` | | `int` | |
| `my.types.map.py.`_``_`.nested.boxed-double` | | `double` |
_Deprecated_ |
- | `my.types.map.py.`_``_`.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]= {"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]= {"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
+ | `my.types.map.py.`_``_`.list-of-strings` | | `list of string` | Example & < > " € ® ©.
* ` session-iam-statements[0]={"Effect":"Allow", "Action":"s3:*", "Resource":"arn:aws:s3:::*/alwaysAllowed/*"} `
* ` session-iam-statements[1]={"Effect":"Deny", "Action":"s3:*", "Resource":"arn:aws:s3:::*/blocked/*"} `
|
| `my.types.map.py.`_``_`.some-int-thing` | | `int` | Something int-ish. |
""");
diff --git a/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestMarkdownFormatter.java b/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestMarkdownFormatter.java
new file mode 100644
index 00000000000..70b1f91fa57
--- /dev/null
+++ b/tools/config-docs/generator/src/test/java/org/apache/polaris/docs/generator/TestMarkdownFormatter.java
@@ -0,0 +1,93 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.polaris.docs.generator;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.util.stream.Stream;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.Arguments;
+import org.junit.jupiter.params.provider.MethodSource;
+
+public class TestMarkdownFormatter {
+
+ static Stream lineBreaks() {
+ return Stream.of(
+ Arguments.of("signs\n temporary credentials", "signs temporary credentials"),
+ Arguments.of("ends it\n early.", "ends it early."),
+ Arguments.of("foo \n bar", "foo bar"),
+ Arguments.of("foo\n\n\nbar", "foo bar"),
+ Arguments.of("foo\t\n\tbar", "foo bar"));
+ }
+
+ @ParameterizedTest
+ @MethodSource("lineBreaks")
+ public void lineBreakBecomesOneSpace(String text, String expected) {
+ var target = new MarkdownFormatter.RootTarget();
+ target.addText(text);
+ assertThat(target.text.toString()).isEqualTo(expected);
+ }
+
+ @Test
+ public void codeWrappedAcrossLinesIsFollowedDirectlyByPunctuation() {
+ var target = new MarkdownFormatter.RootTarget();
+ target.addText("for the storage name ");
+ target.addCode("\n prod");
+ target.addText(". Use");
+ assertThat(target.text.toString()).isEqualTo("for the storage name `prod`. Use");
+ }
+
+ @Test
+ public void codeWrappedAcrossLinesFollowsAnOpeningParenthesisDirectly() {
+ var target = new MarkdownFormatter.RootTarget();
+ target.addText("credential mode (");
+ target.addCode("\n polaris.authentication.credential-mode=EXTERNAL");
+ target.addText("), since");
+ assertThat(target.text.toString())
+ .isEqualTo("credential mode (`polaris.authentication.credential-mode=EXTERNAL`), since");
+ }
+
+ @Test
+ public void codeWrappedAcrossLinesKeepsOneSpaceBeforeTheNextWord() {
+ var target = new MarkdownFormatter.RootTarget();
+ target.addText("the realm feature ");
+ target.addCode("\n ALLOW_SETTING_S3_ENDPOINTS");
+ target.addText(" must stay true");
+ assertThat(target.text.toString())
+ .isEqualTo("the realm feature `ALLOW_SETTING_S3_ENDPOINTS` must stay true");
+ }
+
+ @Test
+ public void codeOnOneLineKeepsItsPunctuation() {
+ var target = new MarkdownFormatter.RootTarget();
+ target.addText("and ");
+ target.addCode("secret-key");
+ target.addText(", and");
+ assertThat(target.text.toString()).isEqualTo("and `secret-key`, and");
+ }
+
+ @Test
+ public void textEndingInWhitespaceGetsOneSeparator() {
+ var target = new MarkdownFormatter.RootTarget();
+ target.addText("foo ");
+ target.addCode("bar");
+ assertThat(target.text.toString()).isEqualTo("foo `bar`");
+ }
+}