Update cross reference syntax in Agent static mode documentation

[clayton-cornell]

PR Description

Topic cross references need to be updated to allow for the fact that the Agent documentation is being reused in the Grafana Cloud documentation.

See https://grafana.com/docs/writers-toolkit/write/shortcodes/#docsreference-shortcode for details of the shortcode used to accomplish this cross referencing from different documentation trees.

Which issue(s) this PR fixes

Notes to the Reviewer

PR Checklist

• CHANGELOG.md updated
• Documentation added
• Tests updated
• Config converters updated

[rfratto]

When do we have to use this new syntax? The syntax is pretty intense.

[rfratto]

Rubber stamp :)

[clayton-cornell]

When do we have to use this new syntax? The syntax is pretty intense.

I've asked for clarification...

[clayton-cornell]

Merging. I'll test in Cloud once it's live. Next step is to migrate Flow docs to the same doc/reference format.

[grafanabot]

The backport to release-v0.33 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new branch
git switch --create backport-4814-to-release-v0.33 origin/release-v0.33
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x 0cd4d262ed65f1999f5d142fd5470ac1fdcc0e38
# Push it to GitHub
git push --set-upstream origin backport-4814-to-release-v0.33
git switch main
# Remove the local backport branch
git branch -D backport-4814-to-release-v0.33

Then, create a pull request where the base branch is release-v0.33 and the compare/head branch is backport-4814-to-release-v0.33.

[grafanabot]

The backport to release-v0.34 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new branch
git switch --create backport-4814-to-release-v0.34 origin/release-v0.34
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x 0cd4d262ed65f1999f5d142fd5470ac1fdcc0e38
# Push it to GitHub
git push --set-upstream origin backport-4814-to-release-v0.34
git switch main
# Remove the local backport branch
git branch -D backport-4814-to-release-v0.34

Then, create a pull request where the base branch is release-v0.34 and the compare/head branch is backport-4814-to-release-v0.34.

[grafanabot]

The backport to release-v0.35 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new branch
git switch --create backport-4814-to-release-v0.35 origin/release-v0.35
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x 0cd4d262ed65f1999f5d142fd5470ac1fdcc0e38
# Push it to GitHub
git push --set-upstream origin backport-4814-to-release-v0.35
git switch main
# Remove the local backport branch
git branch -D backport-4814-to-release-v0.35

Then, create a pull request where the base branch is release-v0.35 and the compare/head branch is backport-4814-to-release-v0.35.