Skip to content

Conversation

mdjermanovic
Copy link
Member

Prerequisites checklist

What is the purpose of this pull request? (put an "X" next to an item)

[ ] Documentation update
[ ] Bug fix (template)
[ ] New rule (template)
[ ] Changes an existing rule (template)
[ ] Add autofix to a rule
[ ] Add a CLI option
[ ] Add something to the core
[x] Other, please explain:

Fixes formatting of unordered lists in all .md files.

In #19628, we upgraded Prettier from v3.3.3 to v3.5.3. In Prettier v3.4.0, a bug with excessive spaces after line prefixes for unordered lists in Markdown has been fixed (https://prettier.io/blog/2024/11/26/3.4.0.html#markdown). As our CI apparently doesn't check the formatting of the entire codebase but just modified files, after merging #19628 a lot of .md files have become incorrectly formatted per Prettier v3.5.3. This is causing problems like:

What changes did you make? (Give an overview)

  1. Installed Prettier locally (npm i prettier --no-save).
  2. Ran npx prettier --write "**/*.md".

Is there anything you'd like reviewers to focus on?

@github-project-automation github-project-automation bot moved this to Needs Triage in Triage Apr 26, 2025
@eslint-github-bot eslint-github-bot bot added the chore This change is not user-facing label Apr 26, 2025
Copy link

netlify bot commented Apr 26, 2025

Deploy Preview for docs-eslint ready!

Name Link
🔨 Latest commit 4ae7544
🔍 Latest deploy log https://app.netlify.com/sites/docs-eslint/deploys/680cad0c37a56d0008f66bb4
😎 Deploy Preview https://deploy-preview-19660--docs-eslint.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@mdjermanovic mdjermanovic marked this pull request as ready for review April 26, 2025 09:17
@mdjermanovic mdjermanovic requested a review from a team as a code owner April 26, 2025 09:17
Comment on lines 86 to 91
::: tip
While there are no restrictions on plugin names, it helps others to find your plugin on [npm](https://npmjs.com) when you follow these naming conventions:

- **Unscoped:** If your npm package name won't be scoped (doesn't begin with `@`), then the plugin name should begin with `eslint-plugin-`, such as `eslint-plugin-example`.
- **Scoped:** If your npm package name will be scoped, then the plugin name should be in the format of `@<scope>/eslint-plugin-<plugin-name>` such as `@jquery/eslint-plugin-jquery` or even `@<scope>/eslint-plugin` such as `@jquery/eslint-plugin`.
:::
- **Unscoped:** If your npm package name won't be scoped (doesn't begin with `@`), then the plugin name should begin with `eslint-plugin-`, such as `eslint-plugin-example`.
- **Scoped:** If your npm package name will be scoped, then the plugin name should be in the format of `@<scope>/eslint-plugin-<plugin-name>` such as `@jquery/eslint-plugin-jquery` or even `@<scope>/eslint-plugin` such as `@jquery/eslint-plugin`.
:::
Copy link
Member Author

Choose a reason for hiding this comment

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

Looks like this fixed a bug we didn't notice on https://eslint.org/docs/latest/extend/plugins.

before

image

after

image

Copy link
Member Author

Choose a reason for hiding this comment

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

Added a blank line before ::: in 4ae7544 to fix its indentation and ensure this doesn't happen again.

@mdjermanovic mdjermanovic marked this pull request as draft April 26, 2025 09:44
@mdjermanovic mdjermanovic marked this pull request as ready for review April 26, 2025 10:01
@mdjermanovic mdjermanovic changed the title chore: fix formatting of unordered lists in Markdown docs: fix formatting of unordered lists in Markdown Apr 26, 2025
@eslint-github-bot eslint-github-bot bot added the documentation Relates to ESLint's documentation label Apr 26, 2025
@mdjermanovic mdjermanovic removed the chore This change is not user-facing label Apr 26, 2025
Copy link
Contributor

@snitin315 snitin315 left a comment

Choose a reason for hiding this comment

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

LGTM

@snitin315 snitin315 added the accepted There is consensus among the team that this change meets the criteria for inclusion label Apr 26, 2025
@snitin315 snitin315 merged commit addd0a6 into main Apr 26, 2025
32 checks passed
@snitin315 snitin315 deleted the formatting-md-unordered-lists branch April 26, 2025 12:15
@github-project-automation github-project-automation bot moved this from Needs Triage to Complete in Triage Apr 26, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
accepted There is consensus among the team that this change meets the criteria for inclusion documentation Relates to ESLint's documentation
Projects
Status: Complete
Development

Successfully merging this pull request may close these issues.

2 participants