add documentation for supported filters in pr automations (#461)

Author: zreigz

generated/routes.json

@@ -85,7 +85,7 @@
   },
   "/getting-started/advanced-config/sandboxing": {
     "relPath": "/getting-started/advanced-config/sandboxing.md",
-    "lastmod": "2025-03-27T19:09:28.000Z"
+    "lastmod": "2025-05-14T21:43:40.000Z"
   },
   "/getting-started/advanced-config/network-configuration": {
     "relPath": "/getting-started/advanced-config/network-configuration.md",
@@ -125,7 +125,7 @@
   },
   "/plural-features/continuous-deployment/pipelines": {
     "relPath": "/plural-features/continuous-deployment/pipelines.md",
-    "lastmod": "2025-04-25T13:05:27.000Z"
+    "lastmod": "2025-05-12T06:30:23.000Z"
   },
   "/plural-features/k8s-upgrade-assistant": {
     "relPath": "/plural-features/k8s-upgrade-assistant/index.md",
@@ -141,7 +141,7 @@
   },
   "/plural-features/k8s-upgrade-assistant/cluster-drain": {
     "relPath": "/plural-features/k8s-upgrade-assistant/cluster-drain.md",
-    "lastmod": "2025-05-12T20:45:36.000Z"
+    "lastmod": "2025-05-13T01:49:39.000Z"
   },
   "/plural-features/stacks-iac-management": {
     "relPath": "/plural-features/stacks-iac-management/index.md",
@@ -225,7 +225,7 @@
   },
   "/plural-features/flows/preview-environments": {
     "relPath": "/plural-features/flows/preview-environments.md",
-    "lastmod": "2025-05-12T00:16:07.000Z"
+    "lastmod": "2025-05-14T21:43:40.000Z"
   },
   "/plural-features/flows/mcp": {
     "relPath": "/plural-features/flows/mcp.md",
@@ -275,6 +275,10 @@
     "relPath": "/plural-features/pr-automation/pipelines.md",
     "lastmod": "2025-03-12T14:59:41.000Z"
   },
+  "/plural-features/pr-automation/filters": {
+    "relPath": "/plural-features/pr-automation/filters.md",
+    "lastmod": "2025-05-16T14:21:39.979Z"
+  },
   "/plural-features/service-templating": {
     "relPath": "/plural-features/service-templating/index.md",
     "lastmod": "2025-03-12T14:59:41.000Z"
@@ -285,7 +289,7 @@
   },
   "/plural-features/projects-and-multi-tenancy": {
     "relPath": "/plural-features/projects-and-multi-tenancy/index.md",
-    "lastmod": "2025-03-12T14:59:41.000Z"
+    "lastmod": "2025-05-15T21:02:36.000Z"
   },
   "/plural-features/notifications": {
     "relPath": "/plural-features/notifications/index.md",
@@ -421,7 +425,7 @@
   },
   "/deployments/sandboxing": {
     "relPath": "/getting-started/advanced-config/sandboxing.md",
-    "lastmod": "2025-03-27T19:09:28.000Z"
+    "lastmod": "2025-05-14T21:43:40.000Z"
   },
   "/deployments/network-configuration": {
     "relPath": "/getting-started/advanced-config/network-configuration.md",
@@ -541,7 +545,7 @@
   },
   "/deployments/multi-tenancy": {
     "relPath": "/plural-features/projects-and-multi-tenancy/index.md",
-    "lastmod": "2025-03-12T14:59:41.000Z"
+    "lastmod": "2025-05-15T21:02:36.000Z"
   },
   "/deployments/notifications": {
     "relPath": "/plural-features/notifications/index.md",

pages/plural-features/pr-automation/crds.md

@@ -7,7 +7,7 @@ You can use our CRD toolkit to generate new PR Automation flows easily. This can
 
 ## Defining Templates
 
-Most of the PR automation works off of Shopify's [Liquid](https://shopify.github.io/liquid/) templating engine. It's a well-documented, widely used templating library that frankly is a bit nicer than go's builtin text/template library.
+Most of the PR automation works off of Shopify's [Liquid](https://shopify.github.io/liquid/) templating engine. It's a well-documented, widely used templating library that frankly is a bit nicer than go's builtin text/template library. Plural provides a set of custom filters that can be used in your templates. For more information, see [Liquid Filters in PR Automation](filters.md).
 
 For this example there are a few templates that are worth mentioning:
 

pages/plural-features/pr-automation/filters.md

@@ -0,0 +1,69 @@
+---
+title: Liquid Filters in PR Automation
+description: Supported Liquid filters for use in PR Automation templates
+---
+
+# Liquid Filters in PR Automation
+
+PR Automation in Plural uses [Liquid](https://shopify.github.io/liquid/) templating engine for generating templates. In addition to the standard Liquid filters, Plural provides a set of custom filters that can be used in your templates.
+
+## Supported Filters
+
+Plural supports a wide range of Liquid filters that can be used in your PR Automation templates. These filters include:
+
+- String manipulation (e.g., `abbrev`, `trim`, `upper`, `lower`)
+- Mathematical operations (e.g., `add`, `sub`, `mul`, `div`)
+- Date formatting (e.g., `date`, `dateInZone`, `dateModify`)
+- Data structure manipulation (e.g., `keys`, `values`, `pick`, `omit`)
+- Encoding/decoding (e.g., `b64enc`, `b64dec`, `urlquery`)
+- And many more
+
+For a complete list of supported filters and detailed documentation for each, please refer to our [Liquid Filters documentation](https://github.com/pluralsh/polly/blob/main/docs/liquid-filters.md).
+
+## Using Filters in Templates
+
+Filters can be used in your Liquid templates to transform data. Here's a simple example:
+
+```liquid
+{{ context.name | upper }}
+```
+
+This would convert the `context.name` value to uppercase.
+
+You can also chain multiple filters:
+
+```liquid
+{{ context.description | trim | truncate: 100 }}
+```
+
+This would trim whitespace from `context.description` and then truncate it to 100 characters.
+
+## Examples
+
+Here are a few examples of how you might use these filters in your PR Automation templates:
+
+### String Manipulation
+
+```liquid
+{{ context.name | lower | replace: " ", "-" }}
+```
+
+This would convert `context.name` to lowercase and replace spaces with hyphens, which is useful for generating URL-friendly slugs.
+
+### Date Formatting
+
+```liquid
+{{ "now" | date: "%Y-%m-%d" }}
+```
+
+This would output the current date in the format "YYYY-MM-DD".
+
+### Mathematical Operations
+
+```liquid
+{{ context.replicas | add: 1 }}
+```
+
+This would add 1 to the value of `context.replicas`.
+
+For more examples and detailed documentation, please refer to our [Liquid Filters documentation](https://github.com/pluralsh/polly/blob/main/docs/liquid-filters.md).

src/routing/docs-structure.ts

@@ -170,6 +170,7 @@ export const docsStructure: DocSection[] = [
           { path: 'crds', title: 'PR automation custom resources' },
           { path: 'testing', title: 'PR automation testing' },
           { path: 'pipelines', title: 'PR automation pipelines' },
+          { path: 'filters', title: 'Liquid Filters in PR Automation' },
         ],
       },
       {