diff --git a/changelog/v1.12.0-beta2/docs-links.yaml b/changelog/v1.12.0-beta2/docs-links.yaml
new file mode 100644
index 00000000000..a00051fad40
--- /dev/null
+++ b/changelog/v1.12.0-beta2/docs-links.yaml
@@ -0,0 +1,3 @@
+changelog:
+  - type: NON_USER_FACING
+    description: Fixes links for various issues raised in Slack.
\ No newline at end of file
diff --git a/docs/content/introduction/architecture/concepts.md b/docs/content/introduction/architecture/concepts.md
index c6f41b0124e..4da4ca33684 100644
--- a/docs/content/introduction/architecture/concepts.md
+++ b/docs/content/introduction/architecture/concepts.md
@@ -131,7 +131,7 @@ Matchers currently support two types of requests:
 
 - **Request Matchers** match on properties of HTTP requests. This includes the request path (`:path` header in HTTP 2.0), method (`:method` in HTTP 2.0) headers (their keys and optionally their values), and query parameters.
 
-- **Event Matchers** match properties of HTTP events, as per the [CloudEvents specification](https://github.com/cloudevents/spec/blob/master/spec.md). The only property **Event Matcher** currently matches on is the *event-type* of an event (specified by the `x-event-type` request header).
+- **Event Matchers** match properties of HTTP events, as per the [CloudEvents specification](https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md). The only property **Event Matcher** currently matches on is the *event-type* of an event (specified by the `x-event-type` request header).
 
 ### Destinations
 
diff --git a/docs/content/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/virtual_service.proto.sk.md b/docs/content/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/virtual_service.proto.sk.md
index 1ef952a966f..27b5af087bf 100644
--- a/docs/content/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/virtual_service.proto.sk.md
+++ b/docs/content/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/virtual_service.proto.sk.md
@@ -154,8 +154,8 @@ An HTTP request is first matched to a virtual host based on its host header, the
 
 If a request is not matched to any virtual host or a route therein, the target proxy will reply with a 404.
 
-Unlike the [Gloo Virtual Host]({{< ref "/reference/api/github.com/solo-io/gloo/projects/gloo/api/v1/proxy.proto.sk.md" >}}/#virtualhost),
-Gateway* Virtual Hosts can **delegate** their routes to `RouteTables`.
+Unlike the [Gloo Virtual Host]({{< versioned_link_path fromRoot="/reference/api/github.com/solo-io/gloo/projects/gloo/api/v1/proxy.proto.sk.md" >}}/#virtualhost),
+_Gateway_ Virtual Hosts can delegate their routes to `RouteTables`.
 
 ```yaml
 "domains": []string
@@ -185,7 +185,7 @@ When a request matches on a route, the route can perform one of the following ac
 - *Route* the request to a destination
 - Reply with a *Direct Response*
 - Send a *Redirect* response to the client
-- *Delegate* the action for the request to one or more top-level [`RouteTable`]({{< ref "/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/route_table.proto.sk.md" >}}) resources
+- *Delegate* the action for the request to one or more top-level [`RouteTable`]({{< versioned_link_path fromRoot="/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/route_table.proto.sk.md" >}}) resources
 DelegateActions can be used to delegate the behavior for a set out routes with a given *prefix* to
 top-level `RouteTable` resources.
 
diff --git a/projects/gateway/api/v1/virtual_service.proto b/projects/gateway/api/v1/virtual_service.proto
index 7797c408353..defd381d991 100644
--- a/projects/gateway/api/v1/virtual_service.proto
+++ b/projects/gateway/api/v1/virtual_service.proto
@@ -148,8 +148,8 @@ An HTTP request is first matched to a virtual host based on its host header, the
 
 If a request is not matched to any virtual host or a route therein, the target proxy will reply with a 404.
 
-Unlike the [Gloo Virtual Host]({{< ref "/reference/api/github.com/solo-io/gloo/projects/gloo/api/v1/proxy.proto.sk.md" >}}/#virtualhost),
-*Gateway* Virtual Hosts can **delegate** their routes to `RouteTables`.
+Unlike the [Gloo Virtual Host]({{< versioned_link_path fromRoot="/reference/api/github.com/solo-io/gloo/projects/gloo/api/v1/proxy.proto.sk.md" >}}/#virtualhost),
+_Gateway_ Virtual Hosts can delegate their routes to `RouteTables`.
 
  */
 message VirtualHost {
@@ -192,7 +192,7 @@ message VirtualHost {
 * - *Route* the request to a destination
 * - Reply with a *Direct Response*
 * - Send a *Redirect* response to the client
-* - *Delegate* the action for the request to one or more top-level [`RouteTable`]({{< ref "/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/route_table.proto.sk.md" >}}) resources
+* - *Delegate* the action for the request to one or more top-level [`RouteTable`]({{< versioned_link_path fromRoot="/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/route_table.proto.sk.md" >}}) resources
 * DelegateActions can be used to delegate the behavior for a set out routes with a given *prefix* to
 * top-level `RouteTable` resources.
 */
diff --git a/projects/gateway/pkg/api/v1/virtual_service.pb.go b/projects/gateway/pkg/api/v1/virtual_service.pb.go
index db73548db96..6704805d477 100644
--- a/projects/gateway/pkg/api/v1/virtual_service.pb.go
+++ b/projects/gateway/pkg/api/v1/virtual_service.pb.go
@@ -294,8 +294,8 @@ func (x *VirtualService) GetMetadata() *core.Metadata {
 //
 //If a request is not matched to any virtual host or a route therein, the target proxy will reply with a 404.
 //
-//Unlike the [Gloo Virtual Host]({{< ref "/reference/api/github.com/solo-io/gloo/projects/gloo/api/v1/proxy.proto.sk.md" >}}/#virtualhost),
-//Gateway* Virtual Hosts can **delegate** their routes to `RouteTables`.
+//Unlike the [Gloo Virtual Host]({{< versioned_link_path fromRoot="/reference/api/github.com/solo-io/gloo/projects/gloo/api/v1/proxy.proto.sk.md" >}}/#virtualhost),
+//_Gateway_ Virtual Hosts can delegate their routes to `RouteTables`.
 //
 type VirtualHost struct {
 	state         protoimpl.MessageState
@@ -413,7 +413,7 @@ func (*VirtualHost_OptionsConfigRefs) isVirtualHost_ExternalOptionsConfig() {}
 // - *Route* the request to a destination
 // - Reply with a *Direct Response*
 // - Send a *Redirect* response to the client
-// - *Delegate* the action for the request to one or more top-level [`RouteTable`]({{< ref "/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/route_table.proto.sk.md" >}}) resources
+// - *Delegate* the action for the request to one or more top-level [`RouteTable`]({{< versioned_link_path fromRoot="/reference/api/github.com/solo-io/gloo/projects/gateway/api/v1/route_table.proto.sk.md" >}}) resources
 // DelegateActions can be used to delegate the behavior for a set out routes with a given *prefix* to
 // top-level `RouteTable` resources.
 type Route struct {