Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs/sources/alerting] Replace docs/reference shortcode with ref URIs #88079

Merged
merged 7 commits into from
May 21, 2024

Conversation

jdbaldry
Copy link
Member

You can use ref URIs in admonitions (or any shortcodes) because they are inline and not subject to the issues noted in the admonition shortcode.

The ref URIs perform the same pattern matching as docs/reference but don't require the use of reference-style links and the destinations are ordinary (full) URLs that can include version substitution. Unlike docs/reference, the implementation doesn't use relref so you don't have to be careful with omitting trailing slashes and the links will follow redirects.

Documentation: https://grafana.com/docs/writers-toolkit/write/links/#link-from-source-content-thats-used-in-multiple-projects

To check the links, refer to the deploy preview in https://github.com/grafana/website/pull/19630.

Signed-off-by: Jack Baldry jack.baldry@grafana.com

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
@grafana-delivery-bot grafana-delivery-bot bot added this to the 11.1.x milestone May 20, 2024
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
@jdbaldry jdbaldry added the no-changelog Skip including change in changelog/release notes label May 20, 2024
@jdbaldry jdbaldry marked this pull request as ready for review May 20, 2024 13:35
@jdbaldry jdbaldry requested a review from brendamuir as a code owner May 20, 2024 13:35
@jdbaldry jdbaldry enabled auto-merge (squash) May 21, 2024 12:41
@jdbaldry jdbaldry merged commit 410e3b1 into main May 21, 2024
12 checks passed
@jdbaldry jdbaldry deleted the jdb/2024-04-use-ref-uris-docs-sources-alerting branch May 21, 2024 12:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
no-changelog Skip including change in changelog/release notes type/docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants