clean up examples, limit scope to extensionRefs

design/10494.md

@@ -46,6 +46,9 @@ A request going through the kgateway will follow the flow below:
 
 ![ai gateway request flow](resources/ai_request_flow.png "ai gateway request flow")
 
+Note: For the first implementation, a RoutePolicy must apply to a specific route on the HTTPRoute
+via an `extensionRef`. This simplifies the assertion that the route the policy is being applied to has a
+valid AI Upstream instead of allowing users to apply the policy via a `targetRef` all routes on the HTTPRoute.
 
 ### APIs
 
@@ -162,16 +165,16 @@ spec:
       namespace: kgateway-system
       group: kgateway.io
       kind: Upstream
+    extensionRefs:
+    - group: gateway.networking.k8s.io
+      kind: HTTPRoute
+      name: openai
 ---
 kind: RoutePolicy
 metadata:
   name: open-ai-opt
   namespace: kgateway-system
 spec:
-  targetRefs:
-  - group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: openai
   ai:
     promptEnrichment:
       prepend:
@@ -212,11 +215,6 @@ metadata:
   name: openai-opt
   namespace: gloo-system
 spec:
-  targetRefs:
-  - group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: openai
-  options:
     ai:
       promptEnrichment:
         prepend:
@@ -246,11 +244,6 @@ metadata:
   name: azure-openai-opt
   namespace: ai-test
 spec:
-  targetRefs:
-  - group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: azure-openai
-  options:
     ai:
       promptGuard:
         request:
@@ -285,11 +278,6 @@ metadata:
   name: azure-openai-opt
   namespace: ai-test
 spec:
-  targetRefs:
-  - group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: azure-openai
-  options:
     ai:
       promptGuard:
         request:
@@ -310,10 +298,6 @@ metadata:
   name: azure-openai-opt
   namespace: ai-test
 spec:
-  targetRefs:
-  - group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: azure-openai
   options:
     ai:
       promptGuard: