Skip to content

style(endpoint-share): format share-url example - #910

Merged
rmdes merged 1 commit into
mainfrom
fix/endpoint-share-readme-formatting
Aug 23, 2026
Merged

style(endpoint-share): format share-url example#910
rmdes merged 1 commit into
mainfrom
fix/endpoint-share-readme-formatting

Conversation

@rmdes

@rmdes rmdes commented Aug 23, 2026

Copy link
Copy Markdown
Collaborator

prettier . --check has failed on packages/endpoint-share/README.md since ba8e19a, when the rel="share-url" example was added.

Because lint runs lint:prettier && lint:js && lint:css, that failure ends the linter step before lint:js and lint:css run, and the Run tests step is skipped — so every pull request currently goes red without its tests being exercised. Spotted while opening #909, whose tests were skipped for this reason.

This is prettier --write output and nothing else — formatting only, no change to the documented markup.

Verified on this branch: npm run lint exits 0 (prettier clean, eslint 0 errors, stylelint clean).

If you'd rather keep the example on one line, a <!-- prettier-ignore --> above the fence would do it instead — happy to switch.

`prettier . --check` has failed on this file since ba8e19a, and because
`lint:prettier` runs before `lint:js` and `lint:css`, the linter step fails
on every pull request before the tests are reached.

Formatting only, no change to the documented markup.
@rmdes
rmdes merged commit 1233c3f into main Aug 23, 2026
1 check passed
@rmdes
rmdes deleted the fix/endpoint-share-readme-formatting branch August 23, 2026 21:27
@paulrobertlloyd

Copy link
Copy Markdown
Collaborator

We should stick to one line and avoid the non-self-closing tag. Prettier’s HTML linting is a bit suspect, and we disable it in .prettierignore. I’m a bit surprised that it caught this, but maybe that’s because it’s HTML embedded in a Markdown document?

Let’s use <!-- prettier-ignore --> instead.

paulrobertlloyd pushed a commit that referenced this pull request Aug 24, 2026
#910 fixed the failing Prettier check by accepting what Prettier wanted,
which split the `<link>` over three lines and made it self-closing. The
trailing slash has no meaning on a void element and reads as though it
does, so the original one-line form is the better documentation.

`.prettierignore` already excludes `*.html`, but this markup is a fenced
block inside a Markdown file, which that pattern does not match — so it
was formatted as embedded code rather than skipped. A
`<!-- prettier-ignore -->` comment excludes just this block and leaves
the rest of the file checked.

`prettier --check` passes across tracked files.
@paulrobertlloyd paulrobertlloyd added code quality Making things easier to understand documentation Good documentation benefits everyone labels Aug 24, 2026
@aciccarello

Copy link
Copy Markdown
Collaborator

Oops! Sorry. Is a better PR check config needed to catch this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

code quality Making things easier to understand documentation Good documentation benefits everyone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants