🤖 fix: auto-discover API reference kinds and nav

Auto-discover root API Kinds for docs/reference/api generation, wire resource/scope
from CRD manifests, and sync MkDocs API nav from generated outputs.

---

_Generated with `mux` • Model: `openai:gpt-5.3-codex` • Thinking: `xhigh` • Cost: `$0.45`_

<!-- mux-attribution: model=openai:gpt-5.3-codex thinking=xhigh costs=0.45 -->

Author: ThomasK33

docs/reference/api/workspaceproxy.md

@@ -0,0 +1,41 @@
+<!-- Code generated by hack/update-reference-docs.sh using github.com/elastic/crd-ref-docs. DO NOT EDIT. -->
+
+# `WorkspaceProxy`
+
+## API identity
+
+- Group/version: `coder.com/v1alpha1`
+- Kind: `WorkspaceProxy`
+- Resource: `workspaceproxies`
+- Scope: namespaced
+
+## Spec
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `spec.image` | `string` | Image is the container image used for the workspace proxy pod. |
+| `spec.replicas` | `int32` | Replicas is the desired number of proxy pods. |
+| `spec.service` | `github.com/coder/coder-k8s/api/v1alpha1.ServiceSpec` | Service controls the service created in front of the workspace proxy. |
+| `spec.primaryAccessURL` | `string` | PrimaryAccessURL is the coderd URL the proxy should connect to. |
+| `spec.proxySessionTokenSecretRef` | `github.com/coder/coder-k8s/api/v1alpha1.SecretKeySelector` | ProxySessionTokenSecretRef points to a Secret key containing the proxy token. |
+| `spec.bootstrap` | `github.com/coder/coder-k8s/api/v1alpha1.ProxyBootstrapSpec` | Bootstrap optionally registers the proxy and mints a proxy token. |
+| `spec.derpOnly` | `bool` | DerpOnly configures the workspace proxy to only serve DERP traffic. |
+| `spec.extraArgs` | `[]string` | ExtraArgs are appended to the default workspace proxy arguments. |
+| `spec.extraEnv` | `[]k8s.io/api/core/v1.EnvVar` | ExtraEnv are injected into the workspace proxy container. |
+| `spec.imagePullSecrets` | `[]k8s.io/api/core/v1.LocalObjectReference` | ImagePullSecrets are used by the pod to pull private images. |
+
+## Status
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `status.observedGeneration` | `int64` | ObservedGeneration tracks the spec generation this status reflects. |
+| `status.readyReplicas` | `int32` | ReadyReplicas is the number of ready pods observed in the deployment. |
+| `status.registered` | `bool` | Registered reports whether bootstrap registration completed successfully. |
+| `status.proxyTokenSecretRef` | `github.com/coder/coder-k8s/api/v1alpha1.SecretKeySelector` | ProxyTokenSecretRef is the Secret used for the proxy session token. |
+| `status.phase` | `string` | Phase is a high-level readiness indicator. |
+| `status.conditions` | `[]metav1.Condition` | Conditions are Kubernetes-standard conditions for this resource. |
+
+## Source
+
+- Go type: `api/v1alpha1/workspaceproxy_types.go`
+- Generated CRD: `config/crd/bases/coder.com_workspaceproxies.yaml`

hack/crd-ref-docs/templates/markdown/gv_list.tpl

@@ -31,6 +31,11 @@
 {{- $scope = "namespaced" -}}
 {{- end -}}
 
+{{- $resource := markdownTemplateValue "resource" -}}
+{{- if eq $resource "" -}}
+{{- $resource = printf "%ss" (lower $kind) -}}
+{{- end -}}
+
 {{- $gv := index $groupVersions 0 -}}
 {{- $rootType := $gv.TypeForKind $kind -}}
 {{- if not $rootType -}}
@@ -65,7 +70,7 @@
 
 - Group/version: `{{ $rootType.GVK.Group }}/{{ $rootType.GVK.Version }}`
 - Kind: `{{ $rootType.GVK.Kind }}`
-- Resource: `{{ printf "%ss" (lower $kind) }}`
+- Resource: `{{ $resource }}`
 - Scope: {{ $scope }}
 
 ## Spec