Improvements

Author: cnasikas

docs/user/alerting/action-types.asciidoc

@@ -11,10 +11,19 @@ a| <<email-action-type, Email>>
 
 | Send email from your server.
 
+a| <<resilient-action-type, IBM Resilient>>
+
+| Create an incident in IBM Resilient.
+
 a| <<index-action-type, Index>>
 
 | Index data into Elasticsearch.
 
+a| <<jira-action-type, Jira>>
+
+| Create an incident in Jira.
+
+
 a| <<pagerduty-action-type, PagerDuty>>
 
 | Send an event in PagerDuty.
@@ -27,17 +36,6 @@ a| <<servicenow-action-type, ServiceNow>>
 
 | Create an incident in ServiceNow.
 
-a| <<jira-action-type, Jira>>
-
-| Create an incident in Jira.
-
-a| <<resilient-action-type, IBM Resilient>>
-
-| Create an incident in IBM Resilient.
-
-a| <<slack-action-type, Slack>>
-| Create an incident in ServiceNow.
-
 a| <<slack-action-type, Slack>>
 
 | Send a message to a Slack channel or user.
@@ -64,12 +62,12 @@ before {kib} starts.
 If you preconfigure a connector, you can also <<preconfigured-action-type-example, preconfigure its action type>>.
 
 include::action-types/email.asciidoc[]
+include::action-types/resilient.asciidoc[]
 include::action-types/index.asciidoc[]
+include::action-types/jira.asciidoc[]
 include::action-types/pagerduty.asciidoc[]
 include::action-types/server-log.asciidoc[]
+include::action-types/servicenow.asciidoc[]
 include::action-types/slack.asciidoc[]
 include::action-types/webhook.asciidoc[]
 include::action-types/pre-configured-connectors.asciidoc[]
-include::action-types/servicenow.asciidoc[]
-include::action-types/jira.asciidoc[]
-include::action-types/resilient.asciidoc[]

docs/user/alerting/action-types/jira.asciidoc

@@ -10,7 +10,7 @@ The Jira action type uses the https://developer.atlassian.com/cloud/jira/platfor
 
 Jira connectors have the following configuration properties:
 
-Name::      The name of the connector. The name is used to identify a  connector in the management UI connector listing, or in the connector list when configuring an action.
+Name::      The name of the connector. The name is used to identify a  connector in the **Stack Management** UI connector listing, and in the connector list when configuring an action.
 URL::       Jira instance URL.
 Project key:: Jira project key.
 Email (or username)::  The account email (or username) for HTTP Basic authentication.
@@ -39,7 +39,7 @@ API token (or password)::  Jira API authentication token (or password) for HTTP
 |===
 
 | `apiUrl`
-| An address that corresponds to *Sender*.
+| An address that corresponds to *URL*.
 
 | `projectKey`
 | A key that corresponds to *Project Key*.
@@ -52,7 +52,7 @@ API token (or password)::  Jira API authentication token (or password) for HTTP
 |===
 
 | `email`
-| A string that corresponds to *User*.
+| A string that corresponds to *Email*.
 
 | `apiToken`
 | A string that corresponds to *API Token*. Should be stored in the <<creating-keystore, {kib} keystore>>.
@@ -67,7 +67,7 @@ Jira actions have the following configuration properties:
 Issue type::              The type of the issue.
 Priority::              The priority of the incident.
 Labels::              The labels of the incident.
-Title::    A title of the issue, used for searching the contents of the knowledge base. 
+Title::    A title for the issue, used for searching the contents of the knowledge base. 
 Description::          The details about the incident.
 Additional comments::  Additional information for the client, such as how to troubleshoot the issue.
 

docs/user/alerting/action-types/resilient.asciidoc

@@ -10,9 +10,9 @@ The IBM Resilient action type uses the https://developer.ibm.com/security/resili
 
 IBM Resilient connectors have the following configuration properties:
 
-Name::      The name of the connector. The name is used to identify a  connector in the management UI connector listing, or in the connector list when configuring an action.
+Name::      The name of the connector. The name is used to identify a  connector in the **Stack Management** UI connector listing, and in the connector list when configuring an action.
 URL::       IBM Resilient instance URL.
-Organization ID:: IBM Resilient organization ID..
+Organization ID:: IBM Resilient organization ID.
 API key ID::  The authentication key ID for HTTP Basic authentication.
 API key secret::  The authentication key secret for HTTP Basic authentication.
 
@@ -39,7 +39,7 @@ API key secret::  The authentication key secret for HTTP Basic authentication.
 |===
 
 | `apiUrl`
-| An address that corresponds to *Sender*.
+| An address that corresponds to *URL*.
 
 | `orgId`
 | An ID that corresponds to *Organization ID*.
@@ -52,7 +52,7 @@ API key secret::  The authentication key secret for HTTP Basic authentication.
 |===
 
 | `apiKeyId`
-| A string that corresponds to *User*.
+| A string that corresponds to *API key ID*.
 
 | `apiKeySecret`
 | A string that corresponds to *API Key secret*. Should be stored in the <<creating-keystore, {kib} keystore>>.
@@ -66,11 +66,11 @@ IBM Resilient actions have the following configuration properties:
 
 Incident types::              The incident types of the incident.
 Severity code::              The severity of the incident.
-Title::    A title of the issue, used for searching the contents of the knowledge base. 
+Name::    A name for the issue, used for searching the contents of the knowledge base. 
 Description::          The details about the incident.
 Additional comments::  Additional information for the client, such as how to troubleshoot the issue.
 
 [[configuring-resilient]]
 ==== Configuring and testing IBM Resilient
 
-IBM Resilient offers free https://www.atlassian.com/software/resilient/free[Instances], which you can use to test incidents.
+IBM Resilient offers https://www.ibm.com/security/intelligent-orchestration/resilient[Instances], which you can use to test incidents.

docs/user/alerting/action-types/servicenow.asciidoc

@@ -10,7 +10,7 @@ The ServiceNow action type uses the https://developer.servicenow.com/app.do#!/re
 
 ServiceNow connectors have the following configuration properties:
 
-Name::      The name of the connector. The name is used to identify a  connector in the management UI connector listing, or in the connector list when configuring an action.
+Name::      The name of the connector. The name is used to identify a  connector in the **Stack Management** UI connector listing, and in the connector list when configuring an action.
 URL::       ServiceNow instance URL.
 Username::  Username for HTTP Basic authentication.
 Password::  Password for HTTP Basic authentication.
@@ -37,7 +37,7 @@ Password::  Password for HTTP Basic authentication.
 |===
 
 | `apiUrl`
-| An address that corresponds to *Sender*.
+| An address that corresponds to *URL*.
 
 |===
 
@@ -47,7 +47,7 @@ Password::  Password for HTTP Basic authentication.
 |===
 
 | `username`
-| A string that corresponds to *User*.
+| A string that corresponds to *Username*.
 
 | `password`
 | A string that corresponds to *Password*. Should be stored in the <<creating-keystore, {kib} keystore>>.
@@ -62,7 +62,7 @@ ServiceNow actions have the following configuration properties:
 Urgency::              The extent to which the incident resolution can delay.
 Severity::             The severity of the incident.
 Impact::               The effect an incident has on business. Can be measured by the number of affected users or by how critical it is to the business in question.
-Short description::    A short description of the incident, used for searching the contents of the knowledge base. 
+Short description::    A short description for the incident, used for searching the contents of the knowledge base. 
 Description::          The details about the incident.
 Additional comments::  Additional information for the client, such as how to troubleshoot the issue.