From 76e66b3f08204f7e12a8255b5a2fb26e416210b5 Mon Sep 17 00:00:00 2001 From: "grafana-delivery-bot[bot]" <132647405+grafana-delivery-bot[bot]@users.noreply.github.com> Date: Tue, 26 Sep 2023 13:32:19 +0300 Subject: [PATCH] [v10.1.x] Fix migrating alerts aliases (#75429) Fix migrating alerts aliases (#74898) * Add comments to indicate which page I believe each alias is intending to redirect Signed-off-by: Jack Baldry * Remove difference-old-new redirect from migrating-alerts page since an alternative page exists The alternative page is `docs/sources/alerting/difference-old-new.md`. Signed-off-by: Jack Baldry * Add comment to show intended absolute path redirect Signed-off-by: Jack Baldry * Remove `unified-alerting/difference-old-new/` redirect because it already exists in `docs/sources/alerting/difference-old-new.md`. Signed-off-by: Jack Baldry * Remove `unified-alerting/` alias since the absolute URL already redirects to `/docs/grafana/latest/alerting/` Signed-off-by: Jack Baldry * Fix `/docs/grafana//alerting/migrating-alerts/` redirect The following example uses `latest` as _`GRAFANA VERSION`_ for simplicity and readability. The desire is the following redirect: ``` src: /docs/grafana/latest/alerting/migrating-alerts/ dst: /docs/grafana/latest/alerting/set-up/migrating-alerts/ ``` `dst` is the Hugo pretty URL for the current page (`docs/sources/alerting/set-up/migrating-alerts/_index.md`). When constructing Hugo aliases we are working from the page's containing directory and not the page itself. The path element `.` represents that directory. For example: ``` page: /docs/grafana/latest/alerting/set-up/migrating-alerts/ alias: ./ dst: /docs/grafana/latest/alerting/set-up/ ``` The path element `..` represents the parent directory of the page's containing directory. For example: ``` page: /docs/grafana/latest/alerting/set-up/migrating-alerts/ alias: ../ dst: /docs/grafana/latest/alerting/ ``` Signed-off-by: Jack Baldry --------- Signed-off-by: Jack Baldry (cherry picked from commit 3ab31c345ec4872b1dbee791001ed1cec7a7a5e3) Co-authored-by: Jack Baldry --- docs/sources/alerting/difference-old-new.md | 2 +- docs/sources/alerting/set-up/migrating-alerts/_index.md | 5 +---- 2 files changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/sources/alerting/difference-old-new.md b/docs/sources/alerting/difference-old-new.md index da40699f3f8..1cd8aaf7773 100644 --- a/docs/sources/alerting/difference-old-new.md +++ b/docs/sources/alerting/difference-old-new.md @@ -2,7 +2,7 @@ _build: list: false aliases: - - unified-alerting/difference-old-new/ + - ./unified-alerting/difference-old-new/ # /docs/grafana//alerting/unified-alerting/difference-old-new/ canonical: https://grafana.com/docs/grafana/latest/alerting/difference-old-new/ description: Compare new unified alerting compared to legacy dashboard alerting keywords: diff --git a/docs/sources/alerting/set-up/migrating-alerts/_index.md b/docs/sources/alerting/set-up/migrating-alerts/_index.md index 2b622b0a711..819e97b9dee 100644 --- a/docs/sources/alerting/set-up/migrating-alerts/_index.md +++ b/docs/sources/alerting/set-up/migrating-alerts/_index.md @@ -1,9 +1,6 @@ --- aliases: - - difference-old-new/ - - unified-alerting/ - - unified-alerting/difference-old-new/ - - alerting/migrating-alerts/ + - ../migrating-alerts/ # /docs/grafana//alerting/migrating-alerts/ canonical: https://grafana.com/docs/grafana/latest/alerting/set-up/migrating-alerts/ description: Upgrade Grafana alerts labels: