[DOCS] Qualified Watcher topics to distinguish from Kib Alerting #65908
Conversation
debadair
added
>docs
|
I wonder if simply changing the headings here would suffice. Changing anchors requires a ton of overhead and creates an awful experience for users with the old URL. While I know the URL impacts SEO, I don't think the marginal SEO gains are worth the friction for users. |
|
@elasticmachine retest this please |
|
I had to revert some of the anchor changes, so ended up reverting all of them. It means that these pages are still possibly more likely to surface in search results than the Kibana Alerting pages, but the heading changes should help clarify things and this way it isn't as disruptive for folks who are using Watcher. |
elasticmachine
added
Team:Data Management
|
Pinging @elastic/es-core-features (Team:Core/Features) |
|
Pinging @elastic/es-docs (Team:Docs) |
| @@ -1,6 +1,9 @@ | |||
| [role="xpack"] | |||
| [[trigger]] | |||
| == Triggers | |||
| [[triggers]] | |||
There was a problem hiding this comment.
Not sure if this anchor change was intentional. If so, we should add a redirect for it.
There was a problem hiding this comment.
I'll revert that one, too.
| @@ -1,6 +1,9 @@ | |||
| [role="xpack"] | |||
| [[actions-email]] | |||
| === Email action | |||
| === Watcher email action | |||
There was a problem hiding this comment.
Should we use the attribute here?
| === Watcher email action | |
| === {watcher} email action |
| [role="xpack"] | ||
| [[xpack-alerting]] | ||
| = Alerting on cluster and index events | ||
| [[watcher-alerting]] | ||
| = Watching for cluster and index events |
There was a problem hiding this comment.
This file looks inert. Maybe remove it entirely?
Also not sure why this isn't just Watch for...
There was a problem hiding this comment.
Will remove it. It's an artifact from when we built standalone getting started "books" for the translation effort.
| @@ -205,7 +205,7 @@ October 28, 2015 | |||
| use the following index name `<logstash-{now/d{YYYY.MM.dd|+01:00}}>`. | |||
|
|
|||
| .New Features | |||
| * Added new <<actions-hipchat,HipChat Action>> | |||
| * Added new <<actionss-hipchat,HipChat Action>> | |||
There was a problem hiding this comment.
Looks like a typo. I think this file may be inert.
| The {alert-features} enable you to watch | ||
| for changes or anomalies in your data and perform the necessary actions in | ||
| TIP: {kib} Alerting provides a set of built-in actions and alerts | ||
| that are integrated with the APM, Metrics, Security, and Uptime applications. |
There was a problem hiding this comment.
There will be more apps that integrate with alerting.
…stic#65908) * [DOCS] Qualified Watcher topics to distinguish from Kib Alerting * Reverted actions anchor due to client links. * Updated redirects. * Fixed links. * Roll back anchor changes * Apply suggestions from code review Co-authored-by: James Rodewig <[email protected]> * Incorporated review comments.
…stic#65908) * [DOCS] Qualified Watcher topics to distinguish from Kib Alerting * Reverted actions anchor due to client links. * Updated redirects. * Fixed links. * Roll back anchor changes * Apply suggestions from code review Co-authored-by: James Rodewig <[email protected]> * Incorporated review comments.
) (#66064) * [DOCS] Qualified Watcher topics to distinguish from Kib Alerting * Reverted actions anchor due to client links. * Updated redirects. * Fixed links. * Roll back anchor changes * Apply suggestions from code review Co-authored-by: James Rodewig <[email protected]> * Incorporated review comments.
) (#66065) * [DOCS] Qualified Watcher topics to distinguish from Kib Alerting * Reverted actions anchor due to client links. * Updated redirects. * Fixed links. * Roll back anchor changes * Apply suggestions from code review Co-authored-by: James Rodewig <[email protected]> * Incorporated review comments.
With the introduction of Kibana Alerting, using Alerting in the Watcher docs is confusing, as are the unqualified actions that overlap. The overlap also has SEO implications that make it less likely for folks to find the Kibana Alerting docs.
This PR qualifies the Watcher headings and anchors that generate the HTML page names, adds the old pages to the redirects file, and updates the necessary xrefs.