Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add docs for courier:batchSearches UI setting #46053

Merged
merged 8 commits into from
Sep 26, 2019

Conversation

lukasolson
Copy link
Member

Resolves #46030.

This PR just adds more clear documentation surrounding the courier:batchSearches UI setting.

@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-docs

@lukasolson lukasolson added the release_note:skip Skip the PR/issue when compiling release notes label Sep 18, 2019
@elasticmachine
Copy link
Contributor

💔 Build Failed

@lukasolson
Copy link
Member Author

Retest (potentially flaky test)

@spalger
Copy link
Contributor

spalger commented Sep 18, 2019

@elasticmachine merge upstream (ABC)

@elasticmachine
Copy link
Contributor

💚 Build Succeeded

@lukasolson
Copy link
Member Author

@elasticmachine merge upstream

@lukasolson
Copy link
Member Author

@AlonaNadler @gchaps Could you provide some feedback about the wording here? Thanks!

@elasticmachine
Copy link
Contributor

💚 Build Succeeded

@elasticmachine
Copy link
Contributor

💚 Build Succeeded

Copy link

@AlonaNadler AlonaNadler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@elasticmachine
Copy link
Contributor

💚 Build Succeeded

@elasticmachine
Copy link
Contributor

💚 Build Succeeded

`Determines whether to send multiple concurrent search requests (such as from a dashboard from multiple
panels) as a single _msearch request, or multiple _search requests. Note that cancellation of queries (for
example, when a user navigates away from the page before the search has returned) is only supported when
using the _search Elasticsearch endpoint.`,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this content reads better without the content in the parens. Can we shorten the text to:

Determines whether to send concurrent search requests as a single _msearch request, or as multiple _search requests. Only the Elasticsearch endpoint supports cancellation of queries.

'times, but it also means that no single search request will be returned until the last has completed.',
`When disabled, dashboard panels will load individually, and search requests will be terminated when users
navigate away or update the query. When enabled, dashboard panels will load altogether when all of the
data has been loaded.`,
}),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like this description. When I looked at the UI, I noticed that the switch is on by default. So how about we describe the default behavior and then explain what happens when you disable:

Screen Shot 2019-09-25 at 12 52 08 PM

What do you think?

Copy link
Contributor

@gchaps gchaps left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@elasticmachine
Copy link
Contributor

💚 Build Succeeded

@lukasolson lukasolson merged commit bfb0df9 into elastic:master Sep 26, 2019
lukasolson added a commit to lukasolson/kibana that referenced this pull request Sep 26, 2019
* Add docs for courier:batchSearches UI setting

* Update ui_setting_defaults.js

* Update ui_setting_defaults.js

* Update advanced-options.asciidoc

* Update advanced-options.asciidoc

* Update ui_setting_defaults.js

* Update advanced-options.asciidoc

* Update ui_setting_defaults.js
lukasolson added a commit to lukasolson/kibana that referenced this pull request Sep 26, 2019
* Add docs for courier:batchSearches UI setting

* Update ui_setting_defaults.js

* Update ui_setting_defaults.js

* Update advanced-options.asciidoc

* Update advanced-options.asciidoc

* Update ui_setting_defaults.js

* Update advanced-options.asciidoc

* Update ui_setting_defaults.js
@lukasolson
Copy link
Member Author

7.x (7.5.0): d85b30a
7.4 (7.4.0): 297f4da

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release_note:skip Skip the PR/issue when compiling release notes Team:Docs v7.4.0 v7.5.0 v8.0.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Change courier:batchSearches advanced setting description to include query termination
5 participants