Merge branch 'master' into import-export-doc

elastic · Jun 9, 2020 · dc61d7a · dc61d7a
2 parents 3fcb5a8 + 0a73891
commit dc61d7a
Show file tree

Hide file tree

Showing 736 changed files with 70,671 additions and 64,821 deletions.
diff --git a/.eslintrc.js b/.eslintrc.js
@@ -758,10 +758,6 @@ module.exports = {
         'react/jsx-no-target-blank': 'error',
         'react/jsx-fragments': 'error',
         'react/jsx-sort-default-props': 'error',
-        // might be introduced after the other warns are fixed
-        // 'react/jsx-sort-props': 'error',
-        // might be introduced after the other warns are fixed
-        'react-hooks/exhaustive-deps': 'off',
         'require-atomic-updates': 'error',
         'symbol-description': 'error',
         'vars-on-top': 'error',

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -34,9 +34,11 @@
 /src/legacy/core_plugins/kibana/public/home/np_ready/ @elastic/kibana-core-ui
 
 # App Architecture
+/examples/developer_examples/ @elastic/kibana-app-arch
 /examples/url_generators_examples/ @elastic/kibana-app-arch
 /examples/url_generators_explorer/ @elastic/kibana-app-arch
 /packages/kbn-interpreter/ @elastic/kibana-app-arch
+/packages/elastic-datemath/ @elastic/kibana-app-arch
 /src/legacy/core_plugins/embeddable_api/ @elastic/kibana-app-arch
 /src/legacy/core_plugins/interpreter/ @elastic/kibana-app-arch
 /src/legacy/core_plugins/kibana_react/ @elastic/kibana-app-arch

diff --git a/docs/dev-tools/console/console.asciidoc b/docs/dev-tools/console/console.asciidoc
@@ -44,7 +44,7 @@ curl -XGET "http://localhost:9200/_search" -d'
 ----------------------------------
 
 When you paste the command into Console, {kib} automatically converts it
-to Console syntax.  Alternatively, if you want to want to see Console syntax in cURL, 
+to Console syntax.  Alternatively, if you want to see Console syntax in cURL, 
 click the action icon (image:dev-tools/console/images/wrench.png[]) and select *Copy as cURL*.
 
 [float]

diff --git a/docs/development/core/public/kibana-plugin-core-public.md b/docs/development/core/public/kibana-plugin-core-public.md
@@ -132,6 +132,12 @@ The plugin integrates with the core system via lifecycle events: `setup`<!-- -->
 |  [URLMeaningfulParts](./kibana-plugin-core-public.urlmeaningfulparts.md) | We define our own typings because the current version of @<!-- -->types/node declares properties to be optional "hostname?: string". Although, parse call returns "hostname: null \| string". |
 |  [UserProvidedValues](./kibana-plugin-core-public.userprovidedvalues.md) | Describes the values explicitly set by user. |
 
+## Variables
+
+|  Variable | Description |
+|  --- | --- |
+|  [URL\_MAX\_LENGTH](./kibana-plugin-core-public.url_max_length.md) | The max URL length allowed by the current browser. Should be used to display warnings to users when query parameters cause URL to exceed this limit. |
+
 ## Type Aliases
 
 |  Type Alias | Description |

diff --git a/docs/development/core/public/kibana-plugin-core-public.url_max_length.md b/docs/development/core/public/kibana-plugin-core-public.url_max_length.md
@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-core-public](./kibana-plugin-core-public.md) &gt; [URL\_MAX\_LENGTH](./kibana-plugin-core-public.url_max_length.md)
+
+## URL\_MAX\_LENGTH variable
+
+The max URL length allowed by the current browser. Should be used to display warnings to users when query parameters cause URL to exceed this limit.
+
+<b>Signature:</b>
+
+```typescript
+URL_MAX_LENGTH: number
+```
diff --git a/...ins/data/public/kibana-plugin-plugins-data-public.indexpattern._constructor_.md b/...ins/data/public/kibana-plugin-plugins-data-public.indexpattern._constructor_.md
@@ -9,7 +9,7 @@ Constructs a new instance of the `IndexPattern` class
 <b>Signature:</b>
 
 ```typescript
-constructor(id: string | undefined, getConfig: any, savedObjectsClient: SavedObjectsClientContract, apiClient: IIndexPatternsApiClient, patternCache: any);
+constructor(id: string | undefined, getConfig: any, savedObjectsClient: SavedObjectsClientContract, apiClient: IIndexPatternsApiClient, patternCache: PatternCache);
 ```
 
 ## Parameters
@@ -20,5 +20,5 @@ constructor(id: string | undefined, getConfig: any, savedObjectsClient: SavedObj
 |  getConfig | <code>any</code> |  |
 |  savedObjectsClient | <code>SavedObjectsClientContract</code> |  |
 |  apiClient | <code>IIndexPatternsApiClient</code> |  |
-|  patternCache | <code>any</code> |  |
+|  patternCache | <code>PatternCache</code> |  |
 
diff --git a/...nt/plugins/data/public/kibana-plugin-plugins-data-public.isearchcontext.core.md b/...nt/plugins/data/public/kibana-plugin-plugins-data-public.isearchcontext.core.md
diff --git a/...ta/public/kibana-plugin-plugins-data-public.isearchcontext.getsearchstrategy.md b/...ta/public/kibana-plugin-plugins-data-public.isearchcontext.getsearchstrategy.md
diff --git a/...lopment/plugins/data/public/kibana-plugin-plugins-data-public.isearchcontext.md b/...lopment/plugins/data/public/kibana-plugin-plugins-data-public.isearchcontext.md
diff --git a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.md b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.md
@@ -67,7 +67,6 @@
 |  [IndexPatternTypeMeta](./kibana-plugin-plugins-data-public.indexpatterntypemeta.md) |  |
 |  [IRequestTypesMap](./kibana-plugin-plugins-data-public.irequesttypesmap.md) |  |
 |  [IResponseTypesMap](./kibana-plugin-plugins-data-public.iresponsetypesmap.md) |  |
-|  [ISearchContext](./kibana-plugin-plugins-data-public.isearchcontext.md) |  |
 |  [ISearchOptions](./kibana-plugin-plugins-data-public.isearchoptions.md) |  |
 |  [ISearchStrategy](./kibana-plugin-plugins-data-public.isearchstrategy.md) | Search strategy interface contains a search method that takes in a request and returns a promise that resolves to a response. |
 |  [ISyncSearchRequest](./kibana-plugin-plugins-data-public.isyncsearchrequest.md) |  |
@@ -157,5 +156,4 @@
 |  [TabbedAggRow](./kibana-plugin-plugins-data-public.tabbedaggrow.md) | \* |
 |  [TimefilterContract](./kibana-plugin-plugins-data-public.timefiltercontract.md) |  |
 |  [TimeHistoryContract](./kibana-plugin-plugins-data-public.timehistorycontract.md) |  |
-|  [TSearchStrategyProvider](./kibana-plugin-plugins-data-public.tsearchstrategyprovider.md) | Search strategy provider creates an instance of a search strategy with the request handler context bound to it. This way every search strategy can use whatever information they require from the request context. |
 
diff --git a/...lugins/data/public/kibana-plugin-plugins-data-public.tsearchstrategyprovider.md b/...lugins/data/public/kibana-plugin-plugins-data-public.tsearchstrategyprovider.md
diff --git a/docs/settings/alert-action-settings.asciidoc b/docs/settings/alert-action-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[alert-action-settings-kb]]
-=== Alerting and action settings in Kibana
+=== Alerting and action settings in {kib}
 ++++
 <titleabbrev>Alerting and action settings</titleabbrev>
 ++++

diff --git a/docs/settings/apm-settings.asciidoc b/docs/settings/apm-settings.asciidoc
@@ -12,7 +12,7 @@ It is enabled by default.
 
 [float]
 [[apm-indices-settings-kb]]
-==== APM Indices
+==== APM indices
 
 // This content is reused in the APM app documentation.
 // Any changes made in this file will be seen there as well.

diff --git a/docs/settings/dev-settings.asciidoc b/docs/settings/dev-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[dev-settings-kb]]
-=== Development tools settings in Kibana
+=== Development tools settings in {kib}
 ++++
 <titleabbrev>Development tools settings</titleabbrev>
 ++++
@@ -21,7 +21,7 @@ They are enabled by default.
 
 [float]
 [[profiler-settings]]
-==== {searchprofiler} Settings
+==== {searchprofiler} settings
 
 [cols="2*<"]
 |===

diff --git a/docs/settings/graph-settings.asciidoc b/docs/settings/graph-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[graph-settings-kb]]
-=== Graph settings in Kibana
+=== Graph settings in {kib}
 ++++
 <titleabbrev>Graph settings</titleabbrev>
 ++++

diff --git a/docs/settings/i18n-settings.asciidoc b/docs/settings/i18n-settings.asciidoc
@@ -1,12 +1,15 @@
 [role="xpack"]
 [[i18n-settings-kb]]
-=== i18n settings in Kibana
+=== i18n settings in {kib}
+++++
+<titleabbrev>i18n settings</titleabbrev>
+++++
 
 You do not need to configure any settings to run Kibana in English.
 
 [float]
 [[general-i18n-settings-kb]]
-==== General i18n Settings
+==== General i18n settings
 
 `i18n.locale`::
   {kib} supports the following locales:

diff --git a/docs/settings/infrastructure-ui-settings.asciidoc b/docs/settings/infrastructure-ui-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[infrastructure-ui-settings-kb]]
-=== Metrics settings in Kibana
+=== Metrics settings in {kib}
 ++++
 <titleabbrev>Metrics settings</titleabbrev>
 ++++
@@ -11,4 +11,4 @@ You do not need to configure any settings to use the Metrics app in {kib}. It is
 [[general-infra-ui-settings-kb]]
 ==== General Metrics settings
 
-include::general-infra-logs-ui-settings.asciidoc[]
+include::general-infra-logs-ui-settings.asciidoc[]
diff --git a/docs/settings/logs-ui-settings.asciidoc b/docs/settings/logs-ui-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[logs-ui-settings-kb]]
-=== Logs app settings in Kibana
+=== Logs settings in {kib}
 ++++
 <titleabbrev>Logs settings</titleabbrev>
 ++++

diff --git a/docs/settings/ml-settings.asciidoc b/docs/settings/ml-settings.asciidoc
@@ -1,12 +1,12 @@
 [role="xpack"]
 [[ml-settings-kb]]
-=== Machine learning settings in Kibana
+=== Machine learning settings in {kib}
 ++++
 <titleabbrev>Machine learning settings</titleabbrev>
 ++++
 
 You do not need to configure any settings to use {kib} {ml-features}. They are
-enabled by default. 
+enabled by default.
 
 [[general-ml-settings-kb]]
 ==== General {ml} settings
@@ -26,4 +26,4 @@ enabled by default.
 [[advanced-ml-settings-kb]]
 ==== Advanced {ml} settings
 
-Refer to <<kibana-ml-settings,Advanced {ml} settings in {kib}>>.
+Refer to <<kibana-ml-settings,Advanced {ml} settings in {kib}>>.
diff --git a/docs/settings/monitoring-settings.asciidoc b/docs/settings/monitoring-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[monitoring-settings-kb]]
-=== Monitoring settings in Kibana
+=== Monitoring settings in {kib}
 ++++
 <titleabbrev>Monitoring settings</titleabbrev>
 ++++

diff --git a/docs/settings/reporting-settings.asciidoc b/docs/settings/reporting-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[reporting-settings-kb]]
-=== Reporting settings in Kibana
+=== Reporting settings in {kib}
 ++++
 <titleabbrev>Reporting settings</titleabbrev>
 ++++

diff --git a/docs/settings/security-settings.asciidoc b/docs/settings/security-settings.asciidoc
@@ -1,6 +1,6 @@
 [role="xpack"]
 [[security-settings-kb]]
-=== Security settings in Kibana
+=== Security settings in {kib}
 ++++
 <titleabbrev>Security settings</titleabbrev>
 ++++

diff --git a/docs/settings/settings-xkb.asciidoc b/docs/settings/settings-xkb.asciidoc
@@ -1,9 +1,9 @@
 [role="xpack"]
 [[settings-xpack-kb]]
-== {xpack} Settings in {kib}
+== {xpack} settings in {kib}
 [subs="attributes"]
 ++++
-<titleabbrev>{xpack} Settings</titleabbrev>
+<titleabbrev>{xpack} settings</titleabbrev>
 ++++
 
 include::{asciidoc-dir}/../../shared/settings.asciidoc[]

diff --git a/docs/settings/telemetry-settings.asciidoc b/docs/settings/telemetry-settings.asciidoc
@@ -1,5 +1,5 @@
 [[telemetry-settings-kbn]]
-=== Telemetry settings in Kibana
+=== Telemetry settings in {kib}
 ++++
 <titleabbrev>Telemetry settings</titleabbrev>
 ++++

diff --git a/docs/setup/access.asciidoc b/docs/setup/access.asciidoc
@@ -1,5 +1,5 @@
 [[access]]
-== Accessing Kibana
+== Access {kib}
 
 Kibana is a web application that you access through port 5601. All you need to do is point your web browser at the
 machine where Kibana is running and specify the port number. For example, `localhost:5601` or `http://YOURDOMAIN.com:5601`.
@@ -13,7 +13,7 @@ If you still don't see any results, it's possible that you don't *have* any docu
 
 [float]
 [[status]]
-=== Checking Kibana Status
+=== Check {kib} status
 
 You can reach the Kibana server's status page by navigating to the status endpoint, for example, `localhost:5601/status`. The status page displays
 information about the server's resource usage and lists the installed plugins.

diff --git a/docs/setup/connect-to-elasticsearch.asciidoc b/docs/setup/connect-to-elasticsearch.asciidoc
@@ -1,5 +1,5 @@
 [[connect-to-elasticsearch]]
-== Adding data
+== Add data to {kib}
 
 To start working with your data in {kib}, you can:
 

diff --git a/docs/setup/docker.asciidoc b/docs/setup/docker.asciidoc
@@ -1,5 +1,5 @@
 [[docker]]
-== Running Kibana on Docker
+=== Install Kibana with Docker
 Docker images for Kibana are available from the Elastic Docker registry. The
 base image is https://hub.docker.com/_/centos/[centos:7].
 
@@ -16,7 +16,7 @@ Elastic license levels.
 
 [float]
 [[pull-image]]
-=== Pulling the image
+=== Pull the image
 
 Obtaining Kibana for Docker is as simple as issuing a +docker pull+ command
 against the Elastic Docker registry.
@@ -40,7 +40,7 @@ available under the Apache 2.0 license. To download the images, go to
 https://www.docker.elastic.co[www.docker.elastic.co].
 
 [float]
-=== Running Kibana on Docker for development
+=== Run Kibana on Docker for development
 Kibana can be quickly started and connected to a local Elasticsearch container for development
 or testing use with the following command:
 --------------------------------------------
@@ -50,7 +50,7 @@ endif::[]
 
 [float]
 [[configuring-kibana-docker]]
-=== Configuring Kibana on Docker
+=== Configure Kibana on Docker
 
 The Docker images provide several methods for configuring Kibana. The
 conventional approach is to provide a `kibana.yml` file as described in

diff --git a/docs/setup/install.asciidoc b/docs/setup/install.asciidoc
@@ -1,13 +1,13 @@
 [[install]]
-== Installing Kibana
+== Install {kib}
 
 [float]
-=== Hosted Kibana
+=== Hosted {kib}
 
 If you are running our hosted Elasticsearch Service on Elastic Cloud, you access Kibana with a single click. (You can {ess-trial}[sign up for a free trial] and start exploring data in minutes.)
 
 [float]
-=== Installing Kibana Yourself
+=== Install {kib} yourself
 
 NOTE: Starting with version 6.0.0, Kibana only supports 64 bit operating systems.
 
@@ -59,10 +59,12 @@ additional setup instructions.
 
 include::install/targz.asciidoc[]
 
+include::install/windows.asciidoc[]
+
 include::install/deb.asciidoc[]
 
 include::install/rpm.asciidoc[]
 
-include::install/windows.asciidoc[]
+include::{kib-repo-dir}/setup/docker.asciidoc[]
 
 include::install/brew.asciidoc[]
diff --git a/docs/setup/install/brew-running.asciidoc b/docs/setup/install/brew-running.asciidoc
@@ -1,6 +1,6 @@
-==== Running Kibana with `brew services`
+==== Run {kib} with `brew services`
 
-With Homebrew, Kibana can be started and stopped as follows: 
+With Homebrew, Kibana can be started and stopped as follows:
 
 [source,sh]
 --------------------------------------------------