Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Conversation

erickzhao
Copy link
Member

Description of Change

Ran through the gamut of npx docusaurus-mdx-checker for the Docusaurus v3 upgrade and this should clear the remaining issues:

  1. { and } both need to be escaped as MDX >=2 supports curly brace JS expressions (ref: https://mdxjs.com/docs/what-is-mdx/#expressions)
  2. MDX >=2 does not support GitHub-flavoured Markdown autolinks such as <https://electronjs.org> (ref: https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3#bad-usage-of-gfm-autolink)
  3. Putting <details><summary>Summary here</summary> doesn't work anymore in MDX >=2 for some reason and we need to add a line break now (ref: https://github.com/orgs/mdx-js/discussions/2241)

cc @electron/docs

Checklist

Release Notes

Notes: none

@electron-cation electron-cation bot added documentation 📓 semver/patch backwards-compatible bug fixes new-pr 🌱 PR opened recently labels May 6, 2024
@erickzhao erickzhao added target/30-x-y PR should also be added to the "30-x-y" branch. target/31-x-y PR should also be added to the "31-x-y" branch. labels May 6, 2024
Copy link
Member

@dsanders11 dsanders11 left a comment

Choose a reason for hiding this comment

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

LGTM. Adding linting support for 1 and 2 to @electron/lint-roller, but it will land after this.

@erickzhao erickzhao added target/30-x-y PR should also be added to the "30-x-y" branch. target/31-x-y PR should also be added to the "31-x-y" branch. and removed target/30-x-y PR should also be added to the "30-x-y" branch. target/31-x-y PR should also be added to the "31-x-y" branch. labels May 6, 2024
@electron-cation electron-cation bot removed the new-pr 🌱 PR opened recently label May 7, 2024
@erickzhao erickzhao added needs-manual-bp/30-x-y and removed target/30-x-y PR should also be added to the "30-x-y" branch. labels May 7, 2024
@erickzhao
Copy link
Member Author

Needs a manual backport for 30-x-y as #41432 (which only landed in v31) fixed an additional unescaped {} instance by adding the WindowOpenHandlerResponse object structure.

@jkleinsc jkleinsc merged commit c3c4173 into electron:main May 7, 2024
@release-clerk
Copy link

release-clerk bot commented May 7, 2024

No Release Notes

@trop
Copy link
Contributor

trop bot commented May 7, 2024

I have automatically backported this PR to "31-x-y", please check out #42070

@trop trop bot added in-flight/31-x-y merged/31-x-y PR was merged to the "31-x-y" branch. and removed target/31-x-y PR should also be added to the "31-x-y" branch. in-flight/31-x-y labels May 7, 2024
erickzhao added a commit to erickzhao/ericktron that referenced this pull request May 8, 2024
@trop
Copy link
Contributor

trop bot commented May 8, 2024

@erickzhao has manually backported this PR to "30-x-y", please check out #42099

@trop trop bot added the in-flight/30-x-y label May 8, 2024
VerteDinde pushed a commit that referenced this pull request May 9, 2024
* docs: update formatting for mdx3 compatibility (#42052)

docs: update formatting for mdx3 compat

* escape curly braces
@trop trop bot added merged/30-x-y PR was merged to the "30-x-y" branch. and removed in-flight/30-x-y labels May 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation 📓 merged/30-x-y PR was merged to the "30-x-y" branch. merged/31-x-y PR was merged to the "31-x-y" branch. semver/patch backwards-compatible bug fixes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

Morty Proxy This is a proxified and sanitized view of the page, visit original site.