Skip to content

[Docs Preview] Bazel Docs : Fix various mdx syntax errors (part 1)#29034

Draft
copybara-service[bot] wants to merge 1 commit intomasterfrom
copybara_docs_preview_885668314
Draft

[Docs Preview] Bazel Docs : Fix various mdx syntax errors (part 1)#29034
copybara-service[bot] wants to merge 1 commit intomasterfrom
copybara_docs_preview_885668314

Conversation

@copybara-service
Copy link
Copy Markdown

Bazel Docs : Fix various mdx syntax errors (part 1)

This CL contains low-risk changes that I either applied via search&replace, or had Gemini CLI fix them via small scripts.

Changes:

  • Removed DevSite fragments before frontmatter
  • Removed <style> sections
  • Replaced HTML comments with JSX comments
  • Fixed graph images in mod-command.mdx
  • Fixed elements by removing DevSite escape sequences [*]
  • Replaced
    and
    with
    and

There are still a lot of problems to fix, but I'd rather do that in a separate CL since they're more risky. In particular, the mdx parser hates it when nested HTML elements appear in the same line. I fixed several examples manually in concepts/dependencies.mdx.

[*] I have no idea whether this actually renders correctly - that's the next step after Mintlify can actually parse the files.

This CL contains low-risk changes that I either applied via search&replace, or had Gemini CLI fix them via small scripts.

Changes:
- Removed DevSite fragments before frontmatter
- Removed <style> sections
- Replaced HTML comments with JSX comments
- Fixed graph images in mod-command.mdx
- Fixed <var> elements by removing DevSite escape sequences [*]
- Replaced <br> and <hr> with <br/> and <hr/>

There are still a lot of problems to fix, but I'd rather do that in a separate CL since they're more risky. In particular, the mdx parser hates it when nested HTML elements appear in the same line. I fixed several examples manually in concepts/dependencies.mdx.

[*] I have no idea whether this actually renders correctly - that's the next step after Mintlify can actually parse the files.

PiperOrigin-RevId: 885668314
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant