Add Data UI Text Review

[alexfrancoeur]

Now that the Add Data UI is merged (#14749) @gchaps will be taking a pass at the tutorial text to make sure the instructions are easy to follow. We'll use this issue to track any text descriptions, format and syntax changes that may be required.

cc: @tsg, @nreese, @jsvd, @ycombinator

[gchaps]

Here are some changes to improve the text on the Home page:

1. Change this intro sentence:

These turnkey solutions will help you quickly add data into Kibana and turn it into pre-built dashboards and monitoring systems.

to:

Use these solutions to quickly turn your data into pre-built dashboards and monitoring systems.

2. Make the "Add data" button in the Logging, Metrics, and Security cards more specific

Add log data
Add metric data
Add security events

[gchaps]

Comments on the Add Data tutorials:

Overall

• Links to documentation should open in a separate tab
• Add Data Home page needs edits for consistency
• Suggested improvements to intro paragraphs
• “Learn more about the xxxx module” can be simplified to “Learn more.”
• APM has a typo and missing ending punctuation
• MySQL Metrics is not consistent with other tutorials. Made suggestions for improvements
• “View exported fields” button is confusing. I expected it to navigate within the UI and not go to the documentation. Maybe because its so close to the Learn more, which is a link. Could both be links: Learn more about the module | View exported fields
• Once all steps are completed, you’re ready to explore your data.” reads better as “Once you complete all steps, you’re ready to explore your data.” Also, its missing ending punctuation

Smaller tweaks

• Type in code block was sometimes red when it should be black
• 32 bits package -> 32-bit package
• In Overview >> Endpoints note Elasticsearch as <es_url> is better as: Overview > Endpoints, note Elasticsearch as <es_url>. (One > and command after Endpoints)

The Google doc list edits per tutorial page.

[alexfrancoeur]

Thanks @gchaps, I appreciate the quick response / review 😄 I'll work with @nreese on your feedback

[alexfrancoeur]

All set, closing this out.