DOC/MEDIUM: #489 allow multiple rewrites in single annotation

Author: dosmanak

documentation/annotations.md

@@ -1051,6 +1051,7 @@ Possible values:
 
 - A single path, such as "/", to turn any path into "/"
 - Two parameters. A regular expression to match and a path to replace it with.
+- Multiline annotation is split into more rewrite rules.
 
 Example:
 
@@ -1059,6 +1060,12 @@ path-rewrite: "/"                        # replace all paths with /
 path-rewrite: (.*) /foo\1                # add the prefix /foo... "/bar?q=1" into "/foo/bar?q=1"
 path-rewrite: ([^?]*)(\?(.*))? \1/foo\2  # add the suffix /foo ... "/bar?q=1" into "/bar/foo?q=1"
 path-rewrite: /foo/(.*) /\1              # strip /foo ... "/foo/bar?q=1" into "/bar?q=1"
+# strip /foo ... "/foo/bar?q=1" into "/bar?q=1" and replace "/bar/*" with "/baz/*"
+# with multiline (using `|`) annotation
+path-rewrite: |
+  /foo/(.*) /\1
+  /bar/(.*) /baz/\1
+
 ```
 
 <p align='right'><a href='#available-annotations'>:arrow_up_small: back to top</a></p>

documentation/doc.yaml

@@ -1105,6 +1105,7 @@ annotations:
     values:
       - A single path, such as "/", to turn any path into "/"
       - Two parameters. A regular expression to match and a path to replace it with.
+      - Multiline annotation is split into more rewrite rules.
     applies_to:
       - configmap
       - ingress
@@ -1114,6 +1115,12 @@ annotations:
       - 'path-rewrite: (.*) /foo\1                # add the prefix /foo... "/bar?q=1" into "/foo/bar?q=1"'
       - 'path-rewrite: ([^?]*)(\?(.*))? \1/foo\2  # add the suffix /foo ... "/bar?q=1" into "/bar/foo?q=1"'
       - 'path-rewrite: /foo/(.*) /\1              # strip /foo ... "/foo/bar?q=1" into "/bar?q=1"'
+      - |
+        # strip /foo ... "/foo/bar?q=1" into "/bar?q=1" and replace "/bar/*" with "/baz/*"
+        # with multiline (using `|`) annotation
+        path-rewrite: |
+          /foo/(.*) /\1
+          /bar/(.*) /baz/\1
   - title: pod-maxconn
     type: number
     group: maximum-concurrent-backend-connections