From a6d87221b6fdb81fcb7d804fdf051b89817066de Mon Sep 17 00:00:00 2001 From: Jared Watts Date: Fri, 26 Jun 2026 18:17:20 -0700 Subject: [PATCH] docs: correct feature flag tables across all versions The feature flag tables on the install pages had drifted from the flags the crossplane binary actually exposes. v2.1, v2.2, v2.3, and master were each missing several flags (--enable-operations, --enable-pipeline-inspector, etc.). This regenerates each table from the flags reported by `crossplane core start --help` on the matching build (v1.20.10, v2.1.7, v2.2.3, v2.3.3, and a v2.4.0-rc main build for master), verifying both flag name and Alpha/Beta status against the binary. Rows now follow a consistent order, with Beta flags before Alpha and alphabetical sorting within each group. v1.20's table was already complete and is reordered here to match the others. Its Helm values table also had pre-existing passive-voice and wordiness Vale warnings that the gate flags once the file is touched, so those are cleaned up too. Signed-off-by: Jared Watts --- content/master/get-started/install.md | 23 ++++++++++++++--------- content/v1.20/software/install.md | 18 +++++++++--------- content/v2.1/get-started/install.md | 20 ++++++++++++-------- content/v2.2/get-started/install.md | 21 +++++++++++++-------- content/v2.3/get-started/install.md | 23 ++++++++++++++--------- 5 files changed, 62 insertions(+), 43 deletions(-) diff --git a/content/master/get-started/install.md b/content/master/get-started/install.md index f7fd6cefc..90793e627 100644 --- a/content/master/get-started/install.md +++ b/content/master/get-started/install.md @@ -103,15 +103,20 @@ at the table below. {{< expand "Feature flags" >}} {{< table caption="Feature flags" >}} -| Status | Flag | Description | -|--------|-----------------------------------------|---------------------------------------------------------------------------| -| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | -| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | -| Alpha | `--enable-provider-deletion-protection` | Enable automatic protection of Providers from deletion when they have active managed resources. Requires `--enable-usages`. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Status | Flag | Description | +|--------|--------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------| +| Beta | `--enable-custom-to-managed-resource-conversion` | Enable support for CRD to MRD conversion when installing a package. | +| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | +| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | +| Beta | `--enable-ssa-claims` | Enable support for using server-side apply to sync claims with XRs. | +| Beta | `--enable-usages` | Enable support for Usages. | +| Alpha | `--enable-dependency-version-downgrades` | Enable automatic version downgrades of dependencies when updating packages. | +| Alpha | `--enable-dependency-version-upgrades` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | +| Alpha | `--enable-operations` | Enable support for Operations. | +| Alpha | `--enable-pipeline-inspector` | Enable support for emitting data about function pipeline runs to a sidecar. | +| Alpha | `--enable-provider-deletion-protection` | Enable automatic protection of Providers from deletion when they have active managed resources. Requires `--enable-usages`. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}} diff --git a/content/v1.20/software/install.md b/content/v1.20/software/install.md index 7434c1c3f..911e58426 100644 --- a/content/v1.20/software/install.md +++ b/content/v1.20/software/install.md @@ -125,7 +125,7 @@ Apply customizations with the command line or with a Helm _values_ file. | `customAnnotations` | Add custom `annotations` to the Crossplane pod deployment. | `{}` | | `customLabels` | Add custom `labels` to the Crossplane pod deployment. | `{}` | | `deploymentStrategy` | The deployment strategy for the Crossplane and RBAC Manager pods. | `"RollingUpdate"` | -| `dnsPolicy` | Specify the `dnsPolicy` to be used by the Crossplane pod. | `""` | +| `dnsPolicy` | Specify the `dnsPolicy` for the Crossplane pod. | `""` | | `extraEnvVarsCrossplane` | Add custom environmental variables to the Crossplane pod deployment. Replaces any `.` in a variable name with `_`. For example, `SAMPLE.KEY=value1` becomes `SAMPLE_KEY=value1`. | `{}` | | `extraEnvVarsRBACManager` | Add custom environmental variables to the RBAC Manager pod deployment. Replaces any `.` in a variable name with `_`. For example, `SAMPLE.KEY=value1` becomes `SAMPLE_KEY=value1`. | `{}` | | `extraObjects` | To add arbitrary Kubernetes Objects during a Helm Install | `[]` | @@ -158,7 +158,7 @@ Apply customizations with the command line or with a Helm _values_ file. | `rbacManager.leaderElection` | Enable [leader election](https://docs.crossplane.io/latest/concepts/pods/#leader-election) for the RBAC Manager pod. | `true` | | `rbacManager.nodeSelector` | Add `nodeSelectors` to the RBAC Manager pod deployment. | `{}` | | `rbacManager.replicas` | The number of RBAC Manager pod `replicas` to deploy. | `1` | -| `rbacManager.revisionHistoryLimit` | The number of RBAC Manager ReplicaSets to retain. | `nil` | +| `rbacManager.revisionHistoryLimit` | The number of RBAC Manager ReplicaSets to keep. | `nil` | | `rbacManager.skipAggregatedClusterRoles` | Don't install aggregated Crossplane ClusterRoles. | `false` | | `rbacManager.tolerations` | Add `tolerations` to the RBAC Manager pod deployment. | `[]` | | `rbacManager.topologySpreadConstraints` | Add `topologySpreadConstraints` to the RBAC Manager pod deployment. | `[]` | @@ -174,7 +174,7 @@ Apply customizations with the command line or with a Helm _values_ file. | `resourcesRBACManager.limits.memory` | Memory resource limits for the RBAC Manager pod. | `"512Mi"` | | `resourcesRBACManager.requests.cpu` | CPU resource requests for the RBAC Manager pod. | `"100m"` | | `resourcesRBACManager.requests.memory` | Memory resource requests for the RBAC Manager pod. | `"256Mi"` | -| `revisionHistoryLimit` | The number of Crossplane ReplicaSets to retain. | `nil` | +| `revisionHistoryLimit` | The number of Crossplane ReplicaSets to keep. | `nil` | | `runtimeClassName` | The runtimeClassName name to apply to the Crossplane and RBAC Manager pods. | `""` | | `securityContextCrossplane.allowPrivilegeEscalation` | Enable `allowPrivilegeEscalation` for the Crossplane pod. | `false` | | `securityContextCrossplane.readOnlyRootFilesystem` | Set the Crossplane pod root file system as read-only. | `true` | @@ -185,7 +185,7 @@ Apply customizations with the command line or with a Helm _values_ file. | `securityContextRBACManager.runAsGroup` | The group ID used by the RBAC Manager pod. | `65532` | | `securityContextRBACManager.runAsUser` | The user ID used by the RBAC Manager pod. | `65532` | | `service.customAnnotations` | Configure annotations on the service object. Only enabled when webhooks.enabled = true | `{}` | -| `serviceAccount.create` | Specifies whether Crossplane ServiceAccount should be created | `true` | +| `serviceAccount.create` | Specifies whether to create the Crossplane ServiceAccount | `true` | | `serviceAccount.customAnnotations` | Add custom `annotations` to the Crossplane ServiceAccount. | `{}` | | `serviceAccount.name` | Provide the name of an already created Crossplane ServiceAccount. Required when `serviceAccount.create` is `false` | `""` | | `tolerations` | Add `tolerations` to the Crossplane pod deployment. | `[]` | @@ -265,14 +265,14 @@ at the table below. | --- | --- | --- | | Beta | `--enable-composition-webhook-schema-validation` | Enable Composition validation using schemas. | | Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-ssa-claims` | Enable support for using server-side apply to sync claims with XRs. | | Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-external-secret-stores` | Enable support for External Secret Stores. | -| Alpha | `--enable-dependency-version-upgrades` | Enable automatic version upgrades of dependencies when updating packages. | +| Beta | `--enable-ssa-claims` | Enable support for using server-side apply to sync claims with XRs. | +| Beta | `--enable-usages` | Enable support for Usages. | | Alpha | `--enable-dependency-version-downgrades` | Enable automatic version downgrades of dependencies when updating packages. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Alpha | `--enable-dependency-version-upgrades` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-external-secret-stores` | Enable support for External Secret Stores. | | Alpha | `--enable-function-response-cache` | Enable support for caching composition function responses. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}} diff --git a/content/v2.1/get-started/install.md b/content/v2.1/get-started/install.md index bc1b6b155..ffde402b5 100644 --- a/content/v2.1/get-started/install.md +++ b/content/v2.1/get-started/install.md @@ -103,14 +103,18 @@ at the table below. {{< expand "Feature flags" >}} {{< table caption="Feature flags" >}} -| Status | Flag | Description | -|--------|-----------------------------------------|---------------------------------------------------------------------------| -| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | -| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Status | Flag | Description | +|--------|--------------------------------------------------|-----------------------------------------------------------------------------| +| Beta | `--enable-custom-to-managed-resource-conversion` | Enable support for CRD to MRD conversion when installing a package. | +| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | +| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | +| Beta | `--enable-ssa-claims` | Enable support for using server-side apply to sync claims with XRs. | +| Beta | `--enable-usages` | Enable support for Usages. | +| Alpha | `--enable-dependency-version-downgrades` | Enable automatic version downgrades of dependencies when updating packages. | +| Alpha | `--enable-dependency-version-upgrades` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | +| Alpha | `--enable-operations` | Enable support for Operations. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}} diff --git a/content/v2.2/get-started/install.md b/content/v2.2/get-started/install.md index bc1b6b155..fcc595bc2 100644 --- a/content/v2.2/get-started/install.md +++ b/content/v2.2/get-started/install.md @@ -103,14 +103,19 @@ at the table below. {{< expand "Feature flags" >}} {{< table caption="Feature flags" >}} -| Status | Flag | Description | -|--------|-----------------------------------------|---------------------------------------------------------------------------| -| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | -| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Status | Flag | Description | +|--------|--------------------------------------------------|-----------------------------------------------------------------------------| +| Beta | `--enable-custom-to-managed-resource-conversion` | Enable support for CRD to MRD conversion when installing a package. | +| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | +| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | +| Beta | `--enable-ssa-claims` | Enable support for using server-side apply to sync claims with XRs. | +| Beta | `--enable-usages` | Enable support for Usages. | +| Alpha | `--enable-dependency-version-downgrades` | Enable automatic version downgrades of dependencies when updating packages. | +| Alpha | `--enable-dependency-version-upgrades` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | +| Alpha | `--enable-operations` | Enable support for Operations. | +| Alpha | `--enable-pipeline-inspector` | Enable support for emitting data about function pipeline runs to a sidecar. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}} diff --git a/content/v2.3/get-started/install.md b/content/v2.3/get-started/install.md index f7fd6cefc..90793e627 100644 --- a/content/v2.3/get-started/install.md +++ b/content/v2.3/get-started/install.md @@ -103,15 +103,20 @@ at the table below. {{< expand "Feature flags" >}} {{< table caption="Feature flags" >}} -| Status | Flag | Description | -|--------|-----------------------------------------|---------------------------------------------------------------------------| -| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | -| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | -| Alpha | `--enable-provider-deletion-protection` | Enable automatic protection of Providers from deletion when they have active managed resources. Requires `--enable-usages`. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Status | Flag | Description | +|--------|--------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------| +| Beta | `--enable-custom-to-managed-resource-conversion` | Enable support for CRD to MRD conversion when installing a package. | +| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | +| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | +| Beta | `--enable-ssa-claims` | Enable support for using server-side apply to sync claims with XRs. | +| Beta | `--enable-usages` | Enable support for Usages. | +| Alpha | `--enable-dependency-version-downgrades` | Enable automatic version downgrades of dependencies when updating packages. | +| Alpha | `--enable-dependency-version-upgrades` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | +| Alpha | `--enable-operations` | Enable support for Operations. | +| Alpha | `--enable-pipeline-inspector` | Enable support for emitting data about function pipeline runs to a sidecar. | +| Alpha | `--enable-provider-deletion-protection` | Enable automatic protection of Providers from deletion when they have active managed resources. Requires `--enable-usages`. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}}