Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 20, 2025

The Setup section contained inconsistent references to the Getting Started guide, using varying verbs ("Follow the steps in", "see", "check") and link text across tutorial pages.

Changes

Standardized all "New to Elastic?" notes in Observability tutorials to use consistent, accessible language:

Before:

**New to Elastic?** Follow the steps in our [getting started guide](...) instead of...

After:

**New to Elastic?** Refer to our [getting started guide](...) instead of...

Files modified

  • solutions/observability/cloud/monitor-microsoft-azure-openai.md
  • solutions/observability/cloud/monitor-microsoft-azure-with-elastic-agent.md
  • solutions/observability/infra-and-hosts/tutorial-observe-nginx-instances.md

"Refer to" provides clearer, more direct language than "Follow the steps in". All links already pointed to the correct target page (/solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent.md).

Original prompt

This section details on the original issue you should resolve

<issue_title>Harmonize the get started references in the Setup section</issue_title>
<issue_description>## Context

The Setup section contains references to the Getting Started, specifically in the following text:

For step-by-step instructions on how to set up an integration, see the Getting Started guide.

The destination page is the same (https://www.elastic.co/docs/solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent), but the link format varies:

  • For step-by-step instructions on how to set up an integration, see the [Getting started](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-observability.html) guide.

  • For step-by-step instructions on how to set up an integration, see the [Getting started](docs-content://solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent.md)

  • For step-by-step instructions on how to set up an integration, check the [Getting started](docs-content://solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent.md)

  • For step-by-step instructions on how to set up an integration, refer to the [Quickstart: Monitor hosts with Elastic Agent](docs-content://solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent.md)

  • For step-by-step instructions on how to set up an integration, see the {{ url "getting-started-observability" "Getting started" }} guide

Actions:

  1. Standardize the link format
  2. Replace "see" with a more accessible term (refer to, check)
  3. Make sure this is the page we want to provide when we guide our customers on how to set up an integration.

CC @elastic/obs-infraobs-integrations @elastic/security-service-integrations </issue_description>

<agent_instructions>Harmonize on the link text used in the examples in this issue. Take into consideration the action items. Assume the page we want to link to is correct.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

  • Fixes elastic/integration-docs#895

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] Harmonize get started references in Setup section Harmonize "Getting Started" references for accessibility and consistency Nov 20, 2025
Copilot AI requested a review from bmorelli25 November 20, 2025 16:54
Copilot finished work on behalf of bmorelli25 November 20, 2025 16:54
@bmorelli25 bmorelli25 closed this Nov 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants