[DOCS] Updates Discover docs by gchaps · Pull Request #82773 · elastic/kibana

gchaps · 2020-11-05T19:28:25Z

Summary

This PR updates the Discover docs as follows:

Combines several topics into a single workflow
Updates images

Preview: https://kibana_82773.docs-preview.app.elstc.co/guide/en/kibana/master/discover.html

KOTungseth · 2020-11-09T18:09:49Z

docs/user/discover.asciidoc

-that best display that data and build better dashboards.
-*Discover* enables you to explore your data, find
-hidden insights and relationships, and get answers to your questions.
+You’ve added your data, and now you’re ready to dig in. You have questions about your data.


Instead of You have questions about your data, how about:

Discover helps you to answer these questions about your data:

What events were logged most recently?

What pages on your website contain a specific word or phrase?

What processes on your server take longer than 500 milliseconds to respond?

I'd prefer not to have back-to-back bulleted lists at the top of the doc.

KOTungseth · 2020-11-09T18:13:24Z

docs/user/discover.asciidoc

+You’ve added your data, and now you’re ready to dig in. You have questions about your data.
+What events were logged most recently? What pages on your website contain a
+specific word or phrase? What processes on your server take longer than 500 milliseconds to respond?
+This tutorial shows you how to use {kib} *Discover* to quickly search large amounts of


Is this how we're supposed to reference Kibana apps? If so, we should open an issue to change these.

KOTungseth · 2020-11-09T18:14:07Z

docs/user/discover.asciidoc

+data and understand what’s going on at any given time.

-With *Discover*, you can:
+You’ll learn to:


This is abrupt. How about:

In Discover, you can:

I'd like to use the wording "you'll learn to". I try to figure out softer wording.

docs/user/discover.asciidoc

KOTungseth · 2020-11-09T18:17:13Z

docs/user/discover.asciidoc

 [float]
-[[select-pattern]]
-=== Set up your index pattern
+=== Prerequisites


Prerequisites should go right before the tasks.

docs/user/discover.asciidoc

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

elasticmachine · 2020-11-10T01:08:37Z

Pinging @elastic/kibana-docs (Team:Docs)

KOTungseth

LGTM!

kertal · 2020-11-11T13:59:05Z

ACK, thx will review today

docs/user/discover.asciidoc

kertal · 2020-11-11T14:39:08Z

docs/user/discover.asciidoc

+=== Step 5. Filter your data
+
+Whereas the query defines the set of documents you are interested in,
+filters enable you to zero in on different subsets of those documents.


TIL: to zero in .. nice

kertal · 2020-11-11T14:43:14Z

docs/user/discover.asciidoc

+Whereas the query defines the set of documents you are interested in,
+filters enable you to zero in on different subsets of those documents.
+You can filter results to include or exclude specific fields,
+filter by data type, filter for a value in a range, and more.


Filter for values, ranges, documents that contain or don't contain fields, yes ... but filtering by data type, I'm not 100% sure what that means in this case

* master: [Security Solution][Detections] Adds framework for replacing API schemas (elastic#82462) [Enterprise Search] Share Loading component (elastic#83246) Consolidates Jest configuration files and scripts (elastic#82671) APM header changes (elastic#82870) [Security Solutions] Adds a default for indicator match custom query of *:* (elastic#81727) [Security Solution] Note 10k object paging limit on Endpoint list (elastic#82889) [packerCache] fix gulp usage, don't archive node_modules (elastic#83327) Upgrade Node.js to version 12 (elastic#61587) [Actions] Removing placeholders and updating validation messages on connector forms (elastic#82734) [Fleet] Rename ingest_manager_api_integration tests fleet_api_integration (elastic#83011) [DOCS] Updates Discover docs (elastic#82773) [ML] Data frame analytics: Adds map view (elastic#81666) enables actions scoped within the stack to register at Basic license (elastic#82931)

kibanamachine · 2020-11-16T17:44:39Z

Friendly reminder: Looks like this PR hasn’t been backported yet.
To create backports run node scripts/backport --pr 82773 or prevent reminders by adding the backport:skip label.

* [DOCS] Updates Discover docs * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * [DOCS] Incorporates review comments * [DOCS] More changes based on edits * [DOCS] Edits per lastest review * [DOCS] Added redirects Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

* [DOCS] Updates Discover docs * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/user/discover.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * [DOCS] Incorporates review comments * [DOCS] More changes based on edits * [DOCS] Edits per lastest review * [DOCS] Added redirects Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

[DOCS] Updates Discover docs

aab3689

gchaps added Team:Docs v8.0.0 release_note:skip Skip the PR/issue when compiling release notes v7.10.0 v7.11.0 labels Nov 5, 2020

gchaps requested a review from KOTungseth November 9, 2020 17:57

KOTungseth reviewed Nov 9, 2020

View reviewed changes

gchaps and others added 10 commits November 9, 2020 14:37

Update docs/user/discover.asciidoc

a2986d3

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

1fb1b9f

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

2fc750b

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

6bfaeac

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

55be51c

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

ce4a0ff

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

c296423

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

97db57f

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/user/discover.asciidoc

37c5482

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

[DOCS] Incorporates review comments

33ca617

gchaps requested a review from kertal November 10, 2020 01:08

gchaps marked this pull request as ready for review November 10, 2020 01:08

[DOCS] More changes based on edits

8256a5e

KOTungseth approved these changes Nov 11, 2020

View reviewed changes

kertal reviewed Nov 11, 2020

View reviewed changes

docs/user/discover.asciidoc Outdated Show resolved Hide resolved

kertal reviewed Nov 11, 2020

View reviewed changes

docs/user/discover.asciidoc Show resolved Hide resolved

kertal reviewed Nov 11, 2020

View reviewed changes

gchaps added 2 commits November 12, 2020 07:42

[DOCS] Edits per lastest review

343b239

[DOCS] Added redirects

7964387

gchaps merged commit 0e565bf into elastic:master Nov 12, 2020

kibanamachine added the backport missing Added to PRs automatically when the are determined to be missing a backport. label Nov 16, 2020

This was referenced Nov 16, 2020

[7.x] [DOCS] Updates Discover docs (#82773) #83462

Merged

[7.10] [DOCS] Updates Discover docs (#82773) #83463

Merged

kibanamachine removed the backport missing Added to PRs automatically when the are determined to be missing a backport. label Nov 16, 2020

Conversation

gchaps commented Nov 5, 2020 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

elasticmachine commented Nov 10, 2020

Uh oh!

KOTungseth left a comment

Choose a reason for hiding this comment

Uh oh!

kertal commented Nov 11, 2020

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kibanamachine commented Nov 16, 2020

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

gchaps commented Nov 5, 2020 •

edited

Loading