[Docs] Update "Alert and action settings" docs to be generated from YAML source

.github/CODEOWNERS

@@ -2040,6 +2040,9 @@ oas_docs/.spectral.yaml                       @elastic/platform-docs
 oas_docs/kibana.info.serverless.yaml          @elastic/platform-docs
 oas_docs/kibana.info.yaml                     @elastic/platform-docs
 
+# Documentation settings files
+docs/settings-gen                             @elastic/platform-docs
+
 # Plugin manifests
 /src/plugins/**/kibana.jsonc @elastic/kibana-core
 /x-pack/plugins/**/kibana.jsonc @elastic/kibana-core

docs/settings-gen/embeds/example-preconfigured-connector-settings.asciidoc

@@ -0,0 +1,11 @@
+For example:
+
+[source,yaml]
+----------------------------------------
+xpack.actions.preconfigured:
+  my-server-log:
+    name: preconfigured-server-log-connector-type
+    actionTypeId: .server-log
+----------------------------------------
+
+For more examples, go to <<pre-configured-connectors>>.

docs/settings-gen/embeds/example-setting-example.asciidoc

@@ -0,0 +1,29 @@
+In the following example, two custom host settings
+are defined.  The first provides a custom host setting for mail server
+`mail.example.com` using port 465 that supplies server certificate authentication
+data from both a file and inline, and requires TLS for the
+connection.  The second provides a custom host setting for https server
+`webhook.example.com` which turns off server certificate authentication,
+that will allow Kibana to connect to the server if it's using a self-signed
+certificate.  The individual properties that can be used in the settings are
+documented below.
+
+[source,yaml]
+--
+xpack.actions.customHostSettings:
+  - url: smtp://mail.example.com:465
+    ssl:
+      verificationMode: 'full'
+      certificateAuthoritiesFiles: [ 'one.crt' ]
+      certificateAuthoritiesData: |
+          -----BEGIN CERTIFICATE-----
+          MIIDTD...
+          CwUAMD...
+          ... multiple lines of certificate data ...
+          -----END CERTIFICATE-----
+    smtp:
+      requireTLS: true
+  - url: https://webhook.example.com
+    ssl:
+      verificationMode: 'none'
+--

docs/settings-gen/embeds/example-xpack-actions-customhostsettings.asciidoc

@@ -0,0 +1,29 @@
+In the following example, two custom host settings
+are defined.  The first provides a custom host setting for mail server
+`mail.example.com` using port 465 that supplies server certificate authentication
+data from both a file and inline, and requires TLS for the
+connection.  The second provides a custom host setting for https server
+`webhook.example.com` which turns off server certificate authentication,
+that will allow Kibana to connect to the server if it's using a self-signed
+certificate.  The individual properties that can be used in the settings are
+documented below.
+
+[source,yaml]
+--
+xpack.actions.customHostSettings:
+  - url: smtp://mail.example.com:465
+    ssl:
+      verificationMode: 'full'
+      certificateAuthoritiesFiles: [ 'one.crt' ]
+      certificateAuthoritiesData: |
+          -----BEGIN CERTIFICATE-----
+          MIIDTD...
+          CwUAMD...
+          ... multiple lines of certificate data ...
+          -----END CERTIFICATE-----
+    smtp:
+      requireTLS: true
+  - url: https://webhook.example.com
+    ssl:
+      verificationMode: 'none'
+--

docs/settings-gen/embeds/example-xpack-actions-proxybypasshosts.asciidoc

@@ -0,0 +1,7 @@
+For example:
+
+[source,yaml]
+----
+# If applicable, include the subdomain in the hostname
+xpack.actions.proxyBypassHosts: [ "events.pagerduty.com" ]
+----

docs/settings-gen/embeds/example-xpack-actions-proxyonlyhosts.asciidoc

@@ -0,0 +1,7 @@
+For example:
+
+[source,yaml]
+----
+# If applicable, include the subdomain in the hostname
+xpack.actions.proxyOnlyHosts: [ "events.pagerduty.com" ]
+----

docs/settings-gen/embeds/example-xpack-actions-proxyurl.asciidoc

@@ -0,0 +1,7 @@
+To help diagnose problems using a proxy, you can use the `curl` command with options to use your proxy, and log debug information, with the following command, replacing the proxy and target URLs as appropriate.  This will force the request to be made to the
+proxy in tunneling mode, and display some of the interaction between the client and the proxy.
+
+[source,sh]
+--
+curl --verbose --proxytunnel --proxy http://localhost:8080 http://example.com
+--

docs/settings-gen/embeds/example-xpack-alerting-rules-run-actions-connectortypeoverrides.asciidoc

@@ -0,0 +1,11 @@
+For example:
+
+[source,yaml]
+--
+xpack.alerting.rules.run:
+    actions:
+        max: 10
+        connectorTypeOverrides:
+            - id: '.server-log'
+              max: 5
+--

docs/settings-gen/embeds/example-xpack-alerting-rules-run-ruletypeoverrides.asciidoc

@@ -0,0 +1,10 @@
+For example:
+
+[source,yaml]
+--
+xpack.alerting.rules.run:
+    timeout: '5m'
+    ruleTypeOverrides:
+        - id: '.index-threshold'
+          timeout: '15m'
+--

docs/settings-gen/embeds/example-xpack.actions-run-connectortypeoverrides.asciidoc

@@ -0,0 +1,10 @@
+For example:
+
+[source,yaml]
+--
+xpack.actions.run:
+    maxAttempts: 1
+    connectorTypeOverrides:
+        - id: '.server-log'
+          maxAttempts: 5
+--

docs/settings-gen/embeds/example-xpack.actions.customHostSettings.asciidoc

@@ -0,0 +1,29 @@
+In the following example, two custom host settings
+are defined.  The first provides a custom host setting for mail server
+`mail.example.com` using port 465 that supplies server certificate authentication
+data from both a file and inline, and requires TLS for the
+connection.  The second provides a custom host setting for https server
+`webhook.example.com` which turns off server certificate authentication,
+that will allow Kibana to connect to the server if it's using a self-signed
+certificate.  The individual properties that can be used in the settings are
+documented below.
+
+[source,yaml]
+--
+xpack.actions.customHostSettings:
+  - url: smtp://mail.example.com:465
+    ssl:
+      verificationMode: 'full'
+      certificateAuthoritiesFiles: [ 'one.crt' ]
+      certificateAuthoritiesData: |
+          -----BEGIN CERTIFICATE-----
+          MIIDTD...
+          CwUAMD...
+          ... multiple lines of certificate data ...
+          -----END CERTIFICATE-----
+    smtp:
+      requireTLS: true
+  - url: https://webhook.example.com
+    ssl:
+      verificationMode: 'none'
+--