Added help text where needed on connectors and alert actions UI

x-pack/plugins/actions/README.md

@@ -426,23 +426,22 @@ The config and params properties are modelled after the [Watcher Index Action](h
 
 ### `config`
 
-| Property | Description                            | Type                |
-| -------- | -------------------------------------- | ------------------- |
-| index    | The Elasticsearch index to index into. | string _(optional)_ |
+| Property             | Description                                                | Type                 |
+| -------------------- | ---------------------------------------------------------- | -------------------- |
+| index                | The Elasticsearch index to index into.                     | string _(optional)_  |
+| doc_id               | The optional \_id of the document.                         | string _(optional)_  |
+| execution_time_field | The field that will store/index the action execution time. | string _(optional)_  |
+| refresh              | Setting of the refresh policy for the write request        | boolean _(optional)_ |
 
 ### `secrets`
 
 This action type has no `secrets` properties.
 
 ### `params`
 
-| Property             | Description                                                | Type                 |
-| -------------------- | ---------------------------------------------------------- | -------------------- |
-| index                | The Elasticsearch index to index into.                     | string _(optional)_  |
-| doc_id               | The optional \_id of the document.                         | string _(optional)_  |
-| execution_time_field | The field that will store/index the action execution time. | string _(optional)_  |
-| refresh              | Setting of the refresh policy for the write request        | boolean _(optional)_ |
-| body                 | The documument body/bodies to index.                       | object or object[]   |
+| Property  | Description                              | Type                |
+| --------- | ---------------------------------------- | ------------------- |
+| documents | JSON object which describe the [document](https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started-index.html#getting-started-batch-processing). | object[]            |
 
 ---
 

x-pack/plugins/triggers_actions_ui/README.md

@@ -900,10 +900,23 @@ export function getActionType(): ActionTypeModel {
 
 ![Index connector card](https://i.imgur.com/fflsmu5.png)
 
-![Index connector form](https://i.imgur.com/tbgyvAL.png)
+![Index connector form](https://i.imgur.com/IkixGMV.png)
 
 and action params form available in Create Alert form:
-![Index action form](https://i.imgur.com/VsWMLeU.png)
+![Index action form](https://i.imgur.com/mpxnPOF.png)
+
+Example of the index document for Index Threshold Alert:
+
+```
+{
+    "alert_id": "{{alertId}}",
+    "alert_name": "{{alertName}}",
+    "alert_instance_id": "{{alertInstanceId}}",
+    "context_title": "{{context.title}}",
+    "context_value": "{{context.value}}",
+    "context_message": "{{context.message}}"
+} 
+```
 
 ### Webhook
 

x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/email/email_connector.tsx

@@ -12,8 +12,10 @@ import {
   EuiFieldPassword,
   EuiSwitch,
   EuiFormRow,
+  EuiSpacer,
 } from '@elastic/eui';
 import { i18n } from '@kbn/i18n';
+import { EuiLink } from '@elastic/eui';
 import { ActionConnectorFieldsProps } from '../../../../types';
 import { EmailActionConnector } from '../types';
 
@@ -195,6 +197,43 @@ export const EmailActionConnectorFields: React.FunctionComponent<ActionConnector
           </EuiFormRow>
         </EuiFlexItem>
       </EuiFlexGroup>
+      <EuiSpacer size="m" />
+      <EuiLink target="_blank" href={'https://support.google.com/a/answer/176600?hl=en'} external>
+        {i18n.translate(
+          'xpack.triggersActionsUI.sections.builtinActionTypes.emailAction.helpGmailLink',
+          {
+            defaultMessage: 'How to configure Gmail',
+          }
+        )}
+      </EuiLink>
+      <EuiSpacer size="m" />
+      <EuiLink
+        target="_blank"
+        href={
+          'https://support.microsoft.com/en-us/office/pop-and-imap-email-settings-for-outlook-8361e398-8af4-4e97-b147-6c6c4ac95353?ui=en-us&rs=en-us&ad=us'
+        }
+        external
+      >
+        {i18n.translate(
+          'xpack.triggersActionsUI.sections.builtinActionTypes.emailAction.helpOutlookLink',
+          {
+            defaultMessage: 'How to configure Outlook',
+          }
+        )}
+      </EuiLink>
+      <EuiSpacer size="m" />
+      <EuiLink
+        target="_blank"
+        href={'https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-connect.html'}
+        external
+      >
+        {i18n.translate(
+          'xpack.triggersActionsUI.sections.builtinActionTypes.emailAction.helpAmazonLink',
+          {
+            defaultMessage: 'How to configure the Amazon SES SMTP Endpoint',
+          }
+        )}
+      </EuiLink>
     </Fragment>
   );
 };

x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/es_index/es_index_connector.tsx

@@ -13,6 +13,7 @@ import {
   EuiSelect,
   EuiTitle,
   EuiIconTip,
+  EuiLink,
 } from '@elastic/eui';
 import { FormattedMessage } from '@kbn/i18n/react';
 import { i18n } from '@kbn/i18n';
@@ -28,7 +29,7 @@ import {
 
 const IndexActionConnectorFields: React.FunctionComponent<ActionConnectorFieldsProps<
   EsIndexActionConnector
->> = ({ action, editActionConfig, errors, http }) => {
+>> = ({ action, editActionConfig, errors, http, docLinks }) => {
   const { index, refresh, executionTimeField } = action.config;
   const [hasTimeFieldCheckbox, setTimeFieldCheckboxState] = useState<boolean>(
     executionTimeField != null
@@ -186,9 +187,9 @@ const IndexActionConnectorFields: React.FunctionComponent<ActionConnectorFieldsP
           </>
         }
       />
-      <EuiSpacer size="m" />
       {hasTimeFieldCheckbox ? (
         <>
+          <EuiSpacer size="m" />
           <EuiFormRow
             id="executionTimeField"
             fullWidth
@@ -217,6 +218,32 @@ const IndexActionConnectorFields: React.FunctionComponent<ActionConnectorFieldsP
           </EuiFormRow>
         </>
       ) : null}
+      <EuiSpacer size="m" />
+      <EuiLink
+        target="_blank"
+        href={'https://github.com/elastic/kibana/tree/master/x-pack/plugins/actions#index'}
+        external
+      >
+        {i18n.translate(
+          'xpack.triggersActionsUI.sections.builtinActionTypes.indexAction.helpConfigureIndexLink',
+          {
+            defaultMessage: 'How to configure Index connector README',
+          }
+        )}
+      </EuiLink>
+      <EuiSpacer size="m" />
+      <EuiLink
+        target="_blank"
+        href={`${docLinks.ELASTIC_WEBSITE_URL}guide/en/elasticsearch/reference/${docLinks.DOC_LINK_VERSION}/getting-started-index.html#getting-started-batch-processing`}
+        external
+      >
+        {i18n.translate(
+          'xpack.triggersActionsUI.sections.builtinActionTypes.indexAction.helpIndexDocLink',
+          {
+            defaultMessage: 'How to index some documents',
+          }
+        )}
+      </EuiLink>
     </>
   );
 };

x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/es_index/es_index_params.tsx

@@ -4,7 +4,7 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 import React, { Fragment } from 'react';
-import { EuiFormRow, EuiCodeEditor } from '@elastic/eui';
+import { EuiFormRow, EuiCodeEditor, EuiSpacer, EuiLink } from '@elastic/eui';
 import { i18n } from '@kbn/i18n';
 import { useXJsonMode } from '../../../../../../../../src/plugins/es_ui_shared/static/ace_x_json/hooks';
 import { ActionParamsProps } from '../../../../types';
@@ -73,6 +73,21 @@ export const IndexParamsFields = ({
           }}
         />
       </EuiFormRow>
+      <EuiSpacer size="m" />
+      <EuiLink
+        target="_blank"
+        href={
+          'https://github.com/elastic/kibana/tree/master/x-pack/plugins/triggers_actions_ui#index'
+        }
+        external
+      >
+        {i18n.translate(
+          'xpack.triggersActionsUI.sections.builtinActionTypes.indexActionParams.helpIndexDocLink',
+          {
+            defaultMessage: 'Example of indexed document',
+          }
+        )}
+      </EuiLink>
     </Fragment>
   );
 };

x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/slack/slack_connectors.tsx

@@ -22,7 +22,7 @@ const SlackActionFields: React.FunctionComponent<ActionConnectorFieldsProps<
         fullWidth
         helpText={
           <EuiLink
-            href="https://www.elastic.co/guide/en/elasticsearch/reference/current/actions-slack.html#configuring-slack"
+            href={`${docLinks.ELASTIC_WEBSITE_URL}guide/en/elasticsearch/reference/${docLinks.DOC_LINK_VERSION}/actions-slack.html#configuring-slack`}
             target="_blank"
           >
             <FormattedMessage