[Management] Update management landing page copy by alisonelizabeth · Pull Request #166732 · elastic/kibana

alisonelizabeth · 2023-09-19T13:54:24Z

Note: The "Endpoints" card copy mentioned in the issue will be added in a separate PR. Also, I'm getting clarification on the "Logs" card for Observability; if we need to add it, it can be done via a separate PR.

elasticmachine · 2023-09-19T17:17:55Z

Pinging @elastic/platform-deployment-management (Team:Deployment Management)

sabarasaba

🚀

lcawl · 2023-09-21T20:16:02Z

IMO the description for the "Connectors" is still possibly confusing for folks who are seeking the search-related connectors. What about something like "Configure connections to third party systems for use in cases and rules."

@shanisagiv1

alisonelizabeth · 2023-09-22T16:03:52Z

IMO the description for the "Connectors" is still possibly confusing for folks who are seeking the search-related connectors. What about something like "Configure connections to third party systems for use in cases and rules."

I'm happy to update the copy to this. @gchaps wdyt?

gchaps · 2023-09-22T20:33:22Z

+1 to

Configure connections to third party systems for use in cases and rules.

gchaps

In looking over this, I felt that the intro was a too short and the descriptions read better when they are 2 lines. Here are my suggestions. I am interested in what others think.

Intro

Manage data and indices, oversee rules and connectors, organize saved objects and files, and create API keys in a central location.

Cards

Configure and maintain your Elasticsearch indices for data storage and retrieval.

Pivot your data or copy the latest documents into an entity-centric index.

Remove fields, extract values, and perform transformations on your data.

Identify, analyze, and process your data using advanced data analysis.

Manage and view the Logstash event processing pipeline from inputs to outputs.

Detect conditions in apps across Kibana and trigger actions.

Configure connections to third party systems for use in cases and rules.

Manage your saved dashboards, maps, data views, and Canvas workloads.

Monitor the generation of PDF, PNG and CSV reports.

Organize, search, and filter your saved objects by specific criteria.

@lcawl @sixstringcode

…_updates

shanisagiv1 · 2023-09-26T10:06:10Z

++
I think since it's under the "Alert & Insights" it's clear that the connectors refer to the alerts but fine with this update.

But since the ML is not part of this section anymore (as it is in stateful).. I'd remove the word "insights" and keep it just "Alerts" - wdyt?

…_updates

gchaps · 2023-09-26T16:00:09Z

+1 to removing "Insights" from the category name.

alisonelizabeth · 2023-09-27T01:22:16Z

@gchaps thanks for the review! I believe I addressed all the feedback. Mind taking another look?

gchaps

Canvas workloads > Canvas workpads. Sorry about that.

Otherwise, text LGTM.

@lcawl, @sixstringcode What do you think of the new intro and shorter text in the cards?

lcawl · 2023-09-27T21:33:36Z

IMO we should try to remove the "Kibana" reference from the Rules intro. How about something like "Define when to generate alerts and notifications".

Likewise I don't think the "Reporting" app enables you to do any monitoring. How about: "Manage generated PDF, PNG and CSV reports".

sixstringcode · 2023-09-27T21:44:49Z

++ I think since it's under the "Alert & Insights" it's clear that the connectors refer to the alerts but fine with this update.

But since the ML is not part of this section anymore (as it is in stateful).. I'd remove the word "insights" and keep it just "Alerts" - wdyt?

I think we should keep it, I'll be adding a few things for Security. Entity Risk only make sense if it still says insights

sixstringcode · 2023-09-27T21:45:27Z

IMO we should try to remove the "Kibana" reference from the Rules intro. How about something like "Define when to generate alerts and notifications".

Likewise I don't think the "Reporting" app enables you to do any monitoring. How about: "Manage generated PDF, PNG and CSV reports".

+1 I have been actively removing references to Kibana as well. It doesn't have any context in the new serverless IA's.

sixstringcode · 2023-09-27T21:54:27Z

@gchaps the new shorter ones look much better. It's VERY minor, but I could see modifying Data Views a little: "Create and manage data you explore from Elasticsearch" or something like that. Object feels like a technical detail we don't need.

We should also capture the ones we haven't added yet here. Advanced Settings we have already discussed, but it looks like we will add Maps, Entity Risk and Visualize Library for Security Projects. We'll need copy for those also. #167453

gchaps · 2023-09-27T22:35:24Z

@sixstringcode How about one of these:

Create and manage the data you retrieved for exploration.
Create and manage the Elasticsearch data you retrieved for exploration.

…_updates

alisonelizabeth · 2023-09-28T02:25:55Z

I've addressed the latest feedback in 271ca6e.

@sixstringcode please advise on the final copy for Data Views.

We should also capture the ones we haven't added yet here. Advanced Settings we have already discussed, but it looks like we will add Maps, Entity Risk and Visualize Library for Security Projects. We'll need copy for those also. #167453

I'm 100% on finalizing copy for these new cards, however, I think the actual code change is out of scope for this PR.

gchaps · 2023-09-28T13:03:54Z

@szabosteve gave me a minor edit to the ML card description so that the word "data" is not repeated:

Identify, analyze, and process your data using advanced analysis techniques.

sixstringcode · 2023-09-28T14:36:54Z

I've addressed the latest feedback in 271ca6e.

@sixstringcode please advise on the final copy for Data Views.

We should also capture the ones we haven't added yet here. Advanced Settings we have already discussed, but it looks like we will add Maps, Entity Risk and Visualize Library for Security Projects. We'll need copy for those also. #167453

I'm 100% on finalizing copy for these new cards, however, I think the actual code change is out of scope for this PR.

Fair, I'll take care of them on #167453

sixstringcode · 2023-09-28T14:38:26Z

@sixstringcode How about one of these:

Create and manage the data you retrieved for exploration.
Create and manage the Elasticsearch data you retrieved for exploration.

I know it's being picky, but the data comes from Elasticsearch. It's really is a filter of the same data. Retrieved makes it sound like it's been moved or copied. Maybe selected or defined?

…_updates

alisonelizabeth · 2023-10-02T14:37:29Z

Final copy feedback applied via 9c01f33

kibana-ci · 2023-10-02T15:45:42Z

💛 Build succeeded, but was flaky

Buildkite Build
Commit: 9c01f33

Failed CI Steps

Test Failures

[job] [logs] FTR Configs #13 / Alerting APIs Alerting rules "after each" hook for "should retry when appropriate"
[job] [logs] FTR Configs #51 / serverless security UI Configure Case "before all" hook in "Configure Case"

Metrics [docs]

Async chunks

Total size of all lazy-loaded chunks that will be downloaded as the user navigates the app

id	before	after	diff
`management`	71.1KB	71.2KB	+73.0B

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id	before	after	diff
`serverlessObservability`	43.5KB	43.5KB	+9.0B
`serverlessSearch`	30.2KB	30.2KB	+9.0B
total			+18.0B

History

💚 Build #163241 succeeded 271ca6e
💚 Build #162688 succeeded 6ed1fac
💚 Build #159989 succeeded bb03680

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

update management page copy

bb03680

alisonelizabeth marked this pull request as ready for review September 19, 2023 17:17

alisonelizabeth requested a review from a team as a code owner September 19, 2023 17:17

alisonelizabeth added Team:Kibana Management Dev Tools, Index Management, Upgrade Assistant, ILM, Ingest Node Pipelines, and more t// release_note:skip Skip the PR/issue when compiling release notes labels Sep 19, 2023

alisonelizabeth added the ui-copy Review of UI copy with docs team is recommended label Sep 19, 2023

alisonelizabeth requested review from gchaps and sabarasaba September 19, 2023 17:30

alisonelizabeth changed the title ~~[Update management page copy~~ [Management] Update management landing page copy Sep 19, 2023

sabarasaba approved these changes Sep 20, 2023

View reviewed changes

gchaps reviewed Sep 22, 2023

View reviewed changes

Merge branch 'main' of github.com:elastic/kibana into management/copy…

d92d0f0

…_updates

alisonelizabeth added 2 commits September 26, 2023 08:43

address copy feedback

cce37bf

Merge branch 'main' of github.com:elastic/kibana into management/copy…

a15c56f

…_updates

fix page description copy

6ed1fac

alisonelizabeth requested a review from gchaps September 27, 2023 01:22

gchaps approved these changes Sep 27, 2023

View reviewed changes

Merge branch 'main' of github.com:elastic/kibana into management/copy…

de09441

…_updates

address additional feedback

271ca6e

alisonelizabeth added 2 commits October 2, 2023 10:23

Merge branch 'main' of github.com:elastic/kibana into management/copy…

df7b20d

…_updates

apply final copy feedback

9c01f33

alisonelizabeth merged commit 972d1da into elastic:main Oct 2, 2023

alisonelizabeth deleted the management/copy_updates branch October 2, 2023 16:22

kibanamachine added v8.11.0 backport:skip This PR does not require backporting labels Oct 2, 2023

Conversation

alisonelizabeth commented Sep 19, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

elasticmachine commented Sep 19, 2023

Uh oh!

sabarasaba left a comment

Choose a reason for hiding this comment

Uh oh!

lcawl commented Sep 21, 2023

Uh oh!

alisonelizabeth commented Sep 22, 2023

Uh oh!

gchaps commented Sep 22, 2023

Uh oh!

gchaps left a comment

Choose a reason for hiding this comment

Uh oh!

shanisagiv1 commented Sep 26, 2023

Uh oh!

gchaps commented Sep 26, 2023

Uh oh!

alisonelizabeth commented Sep 27, 2023

Uh oh!

gchaps left a comment

Choose a reason for hiding this comment

Uh oh!

lcawl commented Sep 27, 2023

Uh oh!

sixstringcode commented Sep 27, 2023

Uh oh!

sixstringcode commented Sep 27, 2023

Uh oh!

sixstringcode commented Sep 27, 2023

Uh oh!

gchaps commented Sep 27, 2023

Uh oh!

alisonelizabeth commented Sep 28, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gchaps commented Sep 28, 2023

Uh oh!

sixstringcode commented Sep 28, 2023

Uh oh!

sixstringcode commented Sep 28, 2023

Uh oh!

alisonelizabeth commented Oct 2, 2023

Uh oh!

kibana-ci commented Oct 2, 2023

💛 Build succeeded, but was flaky

Failed CI Steps

Test Failures

Metrics [docs]

Async chunks

Page load bundle

History

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

alisonelizabeth commented Sep 19, 2023 •

edited

Loading

alisonelizabeth commented Sep 28, 2023 •

edited

Loading