Skip to content

[v2.5.x] Remove inline shortcodes#4883

Merged
mdisibio merged 6 commits intorelease-v2.5from
grafana-tempo-v2.5.x-jdb/2025-03-disable-inline-shortcodes
Mar 24, 2025
Merged

[v2.5.x] Remove inline shortcodes#4883
mdisibio merged 6 commits intorelease-v2.5from
grafana-tempo-v2.5.x-jdb/2025-03-disable-inline-shortcodes

Conversation

@jdbaldry
Copy link
Contributor

Inline shortcodes are powerful templating tools and allow source projects to iterate on HTML templates without a PR to the website repository.

However, by accident or malintent, they can be used break the website or expose information.

On the balance of things, the Docs Platform team believes that the risk outweighs the reward and will be disabling the feature.

The team believes it can support the prompt and safe creation of central shortcodes to satisfy the needs of the source projects.
All existing inline shortcodes have already been translated into central shortcodes that everyone can use.

Created-By: reverse-changes
Repository: grafana/tempo
Website-Pull-Request: https://github.com/grafana/website/pull/24705

It's not worth the risk of letting content define arbitrary templates.

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
@jdbaldry jdbaldry added the type/docs Improvements or additions to documentation label Mar 20, 2025
@grafana grafana deleted a comment from github-actions bot Mar 20, 2025
@jdbaldry jdbaldry marked this pull request as ready for review March 20, 2025 17:29
@knylander-grafana
Copy link
Contributor

Same issue with this PR. It's failing on the validator looking for relrefs.

@jdbaldry
Copy link
Contributor Author

jdbaldry commented Mar 20, 2025

It's also not required here but other required checks haven't been started. It looks like @grafana/tempo need to update the branch ruleset for this branch

@knylander-grafana knylander-grafana enabled auto-merge (squash) March 20, 2025 18:53
@jdbaldry
Copy link
Contributor Author

@grafana/tempo, you'll need to review the branch rules for this release branch I think as it's considered a supported version (at least for the docs).

@mdisibio mdisibio disabled auto-merge March 24, 2025 20:55
@mdisibio mdisibio merged commit ffa1e88 into release-v2.5 Mar 24, 2025
15 checks passed
@mdisibio mdisibio deleted the grafana-tempo-v2.5.x-jdb/2025-03-disable-inline-shortcodes branch March 24, 2025 20:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type/docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants