Finish plugin examples

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

Author: cloudjumpercat

app/_kong_plugins/ace/examples/example.yaml

@@ -0,0 +1,39 @@
+description: 'The ACE plugin only engages with a request when it matches an operation.'
+
+extended_description: |
+  The ACE plugin only engages with a request when it matches an operation. 
+  If a request doesn't match, ACE lets the request pass through untouched. 
+  This means that non-matching requests aren't rejected, but ACE also won't perform authentication and authorization on them. 
+  This allows a request to still be processed by other plugins with a [lower priority](/gateway/entities/plugin/#plugin-priority) than ACE.  
+  
+  A limitation of this method is that all traffic outside of published APIs linked to an ACE-enabled {{site.base_gateway}} won't be access controlled, this must be configured with a different plugin. 
+  Dev Portal will not be able to protect all operations.
+
+  Use cases:
+  * You have an environment where some Gateway Services or Routes are governed by Dev Portal–exposed APIs (with ACE), while others are regular Routes that should be left alone.
+  * You already have existing traffic and other access controls in place and want to avoid interruption.
+
+title: 'Only engage when a request matches an operation'
+
+weight: 900
+
+requirements: 
+- "An API or API package in Dev Portal"
+
+config: 
+  match_policy: required
+  redis: 
+    host: localhost
+    port: 6379
+  sync_rate: 1
+  anonymous: anonymous
+
+min_version:
+  gateway: '3.13'
+
+tools:
+  - deck
+  - admin-api
+  - konnect-api
+  - kic
+  - terraform

app/_kong_plugins/ace/examples/pass-through.yaml

@@ -0,0 +1,34 @@
+description: 'Requires every incoming request to match a defined operation from an API or API package in Dev Portal.'
+
+extended_description: |
+  Requires every incoming request to match a defined operation from an API or API package in Dev Portal. 
+  If a request doesn't match, ACE rejects the request outright with a 404. 
+  All traffic will be rejected except operations or Routes in published APIs linked to an ACE-enabled {{site.base_gateway}}. 
+
+  {:.danger}
+  > **Warning:** Setting the `match_policy` to `required` can **block all traffic with a 404**. Any undefined endpoints will be blocked. If you accidentally enable this in your control planes, this could cause a potential outage in production.
+
+title: 'Require all requests to match operation'
+
+weight: 900
+
+requirements: 
+- "An API or API package in Dev Portal"
+
+config: 
+  match_policy: required
+  redis: 
+    host: localhost
+    port: 6379
+  sync_rate: 1
+  anonymous: anonymous
+
+min_version:
+  gateway: '3.13'
+
+tools:
+  - deck
+  - admin-api
+  - konnect-api
+  - kic
+  - terraform

app/_kong_plugins/ace/examples/require-match.yaml

@@ -0,0 +1,26 @@
+description: 'The ACE plugin skips processing entirely.'
+
+title: 'Skip processing'
+
+weight: 900
+
+requirements: 
+- "An API or API package in Dev Portal"
+
+config: 
+  match_policy: ignored
+  redis: 
+    host: localhost
+    port: 6379
+  sync_rate: 1
+  anonymous: anonymous
+
+min_version:
+  gateway: '3.13'
+
+tools:
+  - deck
+  - admin-api
+  - konnect-api
+  - kic
+  - terraform

app/_kong_plugins/ace/examples/skip-processing.yaml

@@ -5,52 +5,36 @@ name: 'ACE'
 content_type: plugin
 
 publisher: kong-inc
-description: 'placeholder'
-
+description: 'The ACE plugin manages developer access control to APIs published with Dev Portal.'
 
 products:
-    - gateway
+  - gateway
 
 works_on:
-    - konnect
+  - konnect
 
 min_version:
    gateway: '3.13'
 
-# topologies:
-#   on_prem:
-#     - hybrid
-#     - db-less
-#     - traditional
-#   konnect_deployments:
-#     - hybrid
-#     - cloud-gateways
-#     - serverless
-
-# tags:
-#   - traffic-control
-
-# search_aliases:
-#   - plugin-name-in-code eg rate-limiting-advanced
-#   - common aliases, eg OIDC or RLA
-#   - related terms, eg LLM for AI plugins
-  
-######## third-party plugin params, not needed for kong bundled plugins
-# third_party: true
-# source_code_url: ''
-# support_url: ''
-########
-
-# premium_partner: true # can be a kong plugin or a third-party plugin
-
-icon: ace.png # e.g. acme.svg or acme.png
-
-# categories:
-#    - traffic-control
-
-# related_resources:
-#   - text: How-to guide for the plugin
-#     url: /how-to/guide/
+topologies:
+  on_prem:
+    - hybrid
+  konnect_deployments:
+    - hybrid
+    - cloud-gateways
+    - serverless
+
+tags:
+  - traffic-control
+
+icon: ace.png 
+
+categories:
+  - traffic-control
+
+related_resources:
+  - text: Dev Portal API packaging
+    url: /dev-portal/api-catalog-and-packaging/
 ---
 
 The ACE plugin manages developer access control to APIs published with Dev Portal.