Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs: remove broken gfm alert #16902

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

Merged
merged 1 commit into from
Mar 13, 2025
Merged

docs: remove broken gfm alert #16902

merged 1 commit into from
Mar 13, 2025

Conversation

ethanndickson
Copy link
Member

@ethanndickson ethanndickson commented Mar 13, 2025

It looks like GFM does not respect the ![] alert syntax when it's enclosed within a div. This is true for both the coder.com GFM renderer, and GitHub's (though I assume they're the same internally).

When the section is surrounded by a <div class="tabs">:
image

When it's not:
image

Presumably same deal on Coder.com:
image

In our case, we really want the tabs, and the alert block is less important, so we'll downgrade it to a regular quote.

cc @aqandrew for visibility, in case you're aware of a workaround. Merging this for now to remove the broken line.

Copy link
Member Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

Copy link

@cdr-bot cdr-bot bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR is a hotfix and has been automatically approved.

  • ✅ Base is main or release branch
  • ✅ Has hotfix label
  • ✅ Head is from coder/coder
  • ✅ Less than 100 lines

@ethanndickson ethanndickson marked this pull request as ready for review March 13, 2025 05:12
@ethanndickson ethanndickson merged commit 4994ba1 into main Mar 13, 2025
41 checks passed
@ethanndickson ethanndickson deleted the ethan/broken-gfm-alert branch March 13, 2025 05:13
@github-actions github-actions bot locked and limited conversation to collaborators Mar 13, 2025
@aqandrew
Copy link

Thanks for this! Unfortunately I don't know of a workaround.

The rehype-github-alert package that we're using only transforms top-level blockquotes; wrapping the blockquote in any non-root parent element will cause an early return: https://github.com/rehypejs/rehype-github/blob/d602dab29fab941943a14b27d801b18f446636ee/packages/alert/lib/index.js#L60-L69

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants