[docs]: promotion-page link broken
Checklist
- [x] I've searched the issue queue to verify this is not a duplicate bug report.
- [x] I've included steps to reproduce the bug.
- [x] I've pasted the output of
kargo version. - [x] I've pasted logs, if applicable.
Description
The page Promotion Steps cannot be found.
Screenshots
Steps to Reproduce
N/A
Version
v0.9.0`
Logs
N/A
Promotion steps are located at https://docs.kargo.io/user-guide/reference-docs/promotion-steps/
Can you provide some additional information on where exactly you clicked so I can try understanding how you were redirected to user-guide/reference-docs/promotion-tasks/promotion-steps/
The doc build checks for broken links.
Was this an external link maybe?
@rpelczar thinks he found it. The link may have been "external," from Kargo's perspective, in AKP docs.
He also believes updating Docusaurus and rebuilding docs might resolve this. I tried that, but without any success.
@rpelczar can you look, please?
fwiw, I don't think this URL is actually supposed to be valid. It looks wrong. It may be only that the "external" link in AKP docs needs to be corrected.
I found the problem in the docs.
In some places, we added links using relative paths, like in this example: [built-in promotion step](./promotion-steps).
The problem is that whether the link works correctly depends on whether our current URL ends with a slash.
If there is a trailing /, the relative path becomes incorrect.
Documentation says (last section), to avoid this problem, we should link to the file instead of the path, as we already do in many other places.
In this example, we should replace this: [built-in promotion step](./promotion-steps) with [built-in promotion step](30-promotion-steps/index.md.