Conversation
Without it Prettier pulls the text onto the opening line and Docusaurus shows it as the admonition title.
Formatting only, produced by yarn format. No content changes.
security-for-devs.md lost the blank line before its closing ::: in the reformat, so the ::: showed as text. collaboration.md was already broken the same way on main.
lmac-1
marked this pull request as draft
September 25, 2026 12:59
3 tasks
Collaborator
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part 2 of #866. Runs
yarn formatover the whole project. Based on #869: merge that first, then retarget this tomain.Review by commit
Add blank line after two
:::tipopeners. Without the blank line, Prettier pulls the text onto the:::tipline and Docusaurus shows it as the admonition title (docs/design/api-discovery.md,docs/migration/migration-steps.md).Add missing comma in Salesforce job example.
adaptors/library/jobs/workWithIdAfterInsertOrUpsert.jswasn't valid JS, so Prettier couldn't parse it.Run Prettier on the whole project. Formatting only, 153 files, straight from
yarn format. Skim it.Ignore the Prettier reformat in git blame. Adds
.git-blame-ignore-revswith commit 3's SHA. GitHub's blame view reads it automatically. Locally, rungit config blame.ignoreRevsFile .git-blame-ignore-revs.Put two admonition closers back on their own line. The reformat pulled the closing
:::insecurity-for-devs.mdonto the paragraph above, so it showed as text.collaboration.mdwas already broken the same way onmain.Commit 3's SHA only stays valid if this is merged with a merge commit or rebase, not squash. After a squash, update
.git-blame-ignore-revswith the new SHA.Checks
yarn format:checkpasses.:::tip Some textlines in the diff.adaptors/intro.mdxwas formatted as MDX and still renders.yarn generate-library && yarn generate-adaptors && yarn buildpasses. The broken-anchor warnings were there before; the only heading changes are trailing spaces.state =>instead of(state) =>, line wrapping). Two old examples use the comma styleupsert(...), each(...); Prettier wraps them in parens, and they mean the same thing./adaptors: the version lists differ because GitHub rate-limitedgenerate-adaptorsdifferently in each build. Not from Prettier.security-for-devs: a stray:::showed as text. Fixed in commit 5.🤖 Generated with Claude Code