add apiextensions-apiserver to kubernetes known types

renderer/functions.go

@@ -14,6 +14,7 @@
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.
+
 package renderer
 
 import (
@@ -29,7 +30,7 @@ import (
 )
 
 const (
-	kubePackagesRegex   = `^k8s\.io/(?:api|apimachinery/pkg/apis)/`
+	kubePackagesRegex   = `^k8s\.io/(?:api|apimachinery|apiextensions-apiserver/pkg/apis)/`
 	kubeDocLinkTemplate = `https://kubernetes.io/docs/reference/generated/kubernetes-api/v{{ .kubeVersion }}/#{{ .type }}-{{ .version }}-{{ .group }}`
 )
 
@@ -168,10 +169,14 @@ func (k *kubernetesHelper) LinkForKubeType(t *types.Type) string {
 	if len(parts) < 2 {
 		zap.S().Fatalw("Unexpected Kubernetes package name", "type", t)
 	}
-
+	group := strings.ToLower(parts[len(parts)-2])
+	// this is alias handling
+	if group == "apiextensions" {
+		group = "apiextensions-k8s-io"
+	}
 	args := map[string]string{
 		"kubeVersion": k.kubeVersion,
-		"group":       strings.ToLower(parts[len(parts)-2]),
+		"group":       group,
 		"version":     strings.ToLower(parts[len(parts)-1]),
 		"type":        strings.ToLower(t.Name),
 	}

renderer/functions_test.go

@@ -27,13 +27,31 @@ import (
 func TestKubernetesHelper(t *testing.T) {
 	conf := config.Config{
 		Render: config.RenderConfig{
-			KubernetesVersion: "1.15",
+			KubernetesVersion: "1.29",
 		},
 	}
 
 	kh, err := newKubernetesHelper(&conf)
 	require.NoError(t, err)
 
-	link := kh.LinkForKubeType(&types.Type{Package: "k8s.io/apimachinery/pkg/apis/meta/v1", Name: "ObjectMeta"})
-	require.Equal(t, "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.15/#objectmeta-v1-meta", link)
+	cases := []struct {
+		input    *types.Type
+		excepted string
+	}{
+		{
+			input:    &types.Type{Package: "k8s.io/apimachinery/pkg/apis/meta/v1", Name: "ObjectMeta"},
+			excepted: "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#objectmeta-v1-meta",
+		},
+		{
+			input:    &types.Type{Package: "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1", Name: "JSON"},
+			excepted: "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#json-v1-apiextensions-k8s-io",
+		},
+	}
+
+	for _, tc := range cases {
+		t.Run("", func(t *testing.T) {
+			link := kh.LinkForKubeType(tc.input)
+			require.Equal(t, tc.excepted, link)
+		})
+	}
 }

test/api/v1/guestbook_types.go

@@ -20,6 +20,7 @@ package v1
 import (
 	"github.com/elastic/crd-ref-docs/api/common"
 
+	apiextensionsv1 "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	gwapiv1b1 "sigs.k8s.io/gateway-api/apis/v1beta1"
 )
@@ -52,6 +53,8 @@ type Embedded4 struct {
 }
 type EmbeddedX struct {
 	X string `json:"x,omitempty"`
+
+	Value apiextensionsv1.JSON `json:"value,omitempty"`
 }
 
 // Underlying tests that Underlying1's underlying type is Underlying2 instead of string.

test/expected.asciidoc

@@ -68,6 +68,7 @@ Package v1 contains API Schema definitions for the webapp v1 API group
 | *`a`* __string__ |  |  | 
 | *`e`* __string__ |  |  | 
 | *`x`* __string__ |  |  | 
+| *`value`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#json-v1-apiextensions-k8s-io[$$JSON$$]__ |  |  | 
 |===
 
 
@@ -90,6 +91,7 @@ Package v1 contains API Schema definitions for the webapp v1 API group
 | Field | Description | Default | Validation
 | *`e`* __string__ |  |  | 
 | *`x`* __string__ |  |  | 
+| *`value`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#json-v1-apiextensions-k8s-io[$$JSON$$]__ |  |  | 
 |===
 
 
@@ -112,6 +114,7 @@ Package v1 contains API Schema definitions for the webapp v1 API group
 |===
 | Field | Description | Default | Validation
 | *`x`* __string__ |  |  | 
+| *`value`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#json-v1-apiextensions-k8s-io[$$JSON$$]__ |  |  | 
 |===
 
 

test/expected.md

@@ -56,6 +56,7 @@ Package v1 contains API Schema definitions for the webapp v1 API group
 | `a` _string_ |  |  |  |
 | `e` _string_ |  |  |  |
 | `x` _string_ |  |  |  |
+| `value` _[JSON](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#json-v1-apiextensions-k8s-io)_ |  |  |  |
 
 
 #### Embedded1
@@ -73,6 +74,7 @@ _Appears in:_
 | --- | --- | --- | --- |
 | `e` _string_ |  |  |  |
 | `x` _string_ |  |  |  |
+| `value` _[JSON](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#json-v1-apiextensions-k8s-io)_ |  |  |  |
 
 
 #### EmbeddedX
@@ -90,6 +92,7 @@ _Appears in:_
 | Field | Description | Default | Validation |
 | --- | --- | --- | --- |
 | `x` _string_ |  |  |  |
+| `value` _[JSON](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#json-v1-apiextensions-k8s-io)_ |  |  |  |
 
 
 #### Guestbook