docs(vrl): add docs for new validate flag in punycode functions

Related: vectordotdev/vrl#709

website/cue/reference/remap/functions/decode_punycode.cue

@@ -13,6 +13,13 @@ remap: functions: decode_punycode: {
 			required:    true
 			type: ["string"]
 		},
+		{
+			name:        "validate"
+			description: "Whether to validate the input string to check if it is a valid domain name."
+			required:    false
+			type: ["boolean"]
+			default: true
+		},
 	]
 	internal_failure_reasons: [
 		"`value` is not valid `punycode`",
@@ -34,5 +41,12 @@ remap: functions: decode_punycode: {
 				"""
 			return: "www.cafe.com"
 		},
+		{
+			title: "Ignore validation"
+			source: """
+				decode_punycode!("xn--8hbb.xn--fiba.xn--8hbf.xn--eib.", validate: false)
+				"""
+			return: "١٠.٦٦.٣٠.٥."
+		},
 	]
 }

website/cue/reference/remap/functions/encode_punycode.cue

@@ -13,6 +13,13 @@ remap: functions: encode_punycode: {
 			required:    true
 			type: ["string"]
 		},
+		{
+			name:        "validate"
+			description: "Whether to validate the input string to check if it is a valid domain name."
+			required:    false
+			type: ["boolean"]
+			default: true
+		},
 	]
 	internal_failure_reasons: [
 		"`value` can not be encoded to `punycode`",
@@ -41,5 +48,12 @@ remap: functions: encode_punycode: {
 				"""
 			return: "www.cafe.com"
 		},
+		{
+			title: "Ignore validation"
+			source: """
+				encode_punycode!("xn--8hbb.xn--fiba.xn--8hbf.xn--eib.", validate: false)
+				"""
+			return: "xn--8hbb.xn--fiba.xn--8hbf.xn--eib."
+		},
 	]
 }