Skip to content

Commit dc7ec91

Browse files
github-actions[bot]Radoslav Dimitrov
andcommitted
Tighten v0.23.0 migration and redirectUri sections
Apply editorial fixes from docs-review pass: replace spaced-hyphen separators in prose with natural punctuation, soften the v1alpha1 removal commitment to match the release notes' 'future release' phrasing, and correct 'v1beta1 API group' to just 'v1beta1' since v1beta1 is a version under the toolhive.stacklok.dev API group. Co-authored-by: Radoslav Dimitrov <undefined@users.noreply.github.com>
1 parent ad11f6b commit dc7ec91

2 files changed

Lines changed: 7 additions & 8 deletions

File tree

docs/toolhive/guides-k8s/auth-k8s.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -832,7 +832,7 @@ upstreamProviders:
832832
key: client-secret
833833
```
834834

835-
Whichever value ends up in effect - defaulted or explicit - must exactly match
835+
The effective redirect URI, whether defaulted or explicit, must exactly match
836836
the redirect URI registered with the upstream identity provider.
837837

838838
## Set up authorization

docs/toolhive/guides-k8s/migrate-to-v1beta1.mdx

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -724,7 +724,7 @@ VirtualMCPServer.
724724

725725
:::info[No schema changes]
726726

727-
The `v1alpha1` and `v1beta1` schemas are identical - `v1alpha1` is a
727+
The `v1alpha1` and `v1beta1` schemas are identical. `v1alpha1` is a
728728
deprecation-only passthrough that reuses the `v1beta1` types. The CRDs use the
729729
default `None` conversion strategy, so no conversion webhook is required and
730730
existing resources continue to work unchanged after the upgrade.
@@ -749,17 +749,16 @@ Migration steps:
749749
```
750750

751751
3. Re-apply the updated manifests. Because both versions are still served, you
752-
can update resources incrementally - deprecation warnings call out each
752+
can update resources incrementally. Deprecation warnings call out each
753753
manifest that still uses `v1alpha1`:
754754

755755
```bash
756756
kubectl apply -f my-mcpserver.yaml
757757
```
758758

759759
4. Update any client tooling, Helm charts, GitOps repositories, and generated
760-
typed clients to reference the `v1beta1` API group. After all resources have
761-
been re-applied, `kubectl get <resource>` returns `v1beta1` objects from
762-
etcd.
760+
typed clients to reference `v1beta1`. After all resources have been
761+
re-applied, `kubectl get <resource>` returns `v1beta1` objects from etcd.
763762

764763
:::tip[Identify lingering `v1alpha1` usage]
765764

@@ -770,8 +769,8 @@ surfaces in `kubectl` output.
770769

771770
:::
772771

773-
`v1alpha1` will remain served for at least one additional minor release before
774-
being removed; update now to avoid a forced migration later.
772+
`v1alpha1` will be removed in a future release; update now to avoid a forced
773+
migration later.
775774

776775
## Next steps
777776

0 commit comments

Comments
 (0)