[DOCS] Updates Discover docs #82773

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


-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


 [role="screenshot"]
 image::images/Discover-Start.png[Discover]


 [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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[DOCS] Updates Discover docs #82773

[DOCS] Updates Discover docs #82773

gchaps commented Nov 5, 2020 •

edited

Loading

KOTungseth Nov 9, 2020

gchaps Nov 9, 2020

KOTungseth Nov 9, 2020

gchaps Nov 9, 2020

KOTungseth Nov 9, 2020

gchaps Nov 9, 2020

KOTungseth Nov 9, 2020

elasticmachine commented Nov 10, 2020

KOTungseth left a comment

kertal commented Nov 11, 2020

kertal Nov 11, 2020

kertal Nov 11, 2020

kibanamachine commented Nov 16, 2020

[DOCS] Updates Discover docs #82773

[DOCS] Updates Discover docs #82773

Conversation

gchaps commented Nov 5, 2020 • edited Loading

Summary

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

elasticmachine commented Nov 10, 2020

KOTungseth left a comment

Choose a reason for hiding this comment

kertal commented Nov 11, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kibanamachine commented Nov 16, 2020

gchaps commented Nov 5, 2020 •

edited

Loading