Links to HTML anchors in /reference/spec/ are broken

[blake]

Problem

PR #3697 (commit b69fa43) changed the tool used to generate the CRD reference docs from ahmetb/gen-crd-api-reference-docs to elastic/crd-ref-docs. This had the unintended side effect of breaking links to resources on https://gateway-api.sigs.k8s.io/reference/spec/ because the HTML anchors generated by the two tools are different. For example:

Before: #gateway.networking.k8s.io/v1.HTTPRouteRule
After: #httprouterule

(The latter is missing the group and version. The kind is lowercased.)

Potential solutions

1. Update all links across the site to point to the new, updated anchors.
2. Configure elastic/crd-ref-docs to use a custom template that generates anchors using the previous format. (See crd-ref-docs's --templates flag.)

[k8s-triage-robot]

The Kubernetes project currently lacks enough contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

• After 90d of inactivity, lifecycle/stale is applied
• After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
• After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

• Mark this issue as fresh with /remove-lifecycle stale
• Close this issue with /close
• Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle stale