Skip to content

feat!: update default rule doc title and notices to separate rule name and description#835

Merged
bmish merged 5 commits into
mainfrom
rule-doc-title-desc-notice
Jan 1, 2026
Merged

feat!: update default rule doc title and notices to separate rule name and description#835
bmish merged 5 commits into
mainfrom
rule-doc-title-desc-notice

Conversation

@bmish
Copy link
Copy Markdown
Member

@bmish bmish commented Jan 1, 2026

Changes default title format and adds description notice

This PR updates the default --rule-doc-title-format from desc-parens-prefix-name to prefix-name (e.g., # test/no-foo instead of # Disallow use of foo (test/no-foo)), adds description as a new default notice in --rule-doc-notices (appearing last in the list after configs, deprecated, fixableAndHasSuggestions, and requiresTypeChecking), and introduces the 📝 emoji for the description notice type to maintain consistency with other notice types.

This is a long-requested change. The goal is to be more consistent with ESLint/typescript-eslint and give the rule description the dedicated line that it deserves, while keeping the title short and simple.

Note that you can revert to the old behavior using the config options. Please provide feedback if these new defaults cause issues.

Fixes #347.

BEGIN_COMMIT_OVERRIDE
feat!: Update default rule doc title and notices to separate rule name and description
END_COMMIT_OVERRIDE

@bmish bmish changed the title feat: update default rule doc title and notices to separate rule name and description feat!: update default rule doc title and notices to separate rule name and description Jan 1, 2026
@bmish bmish added the breaking label Jan 1, 2026
@bmish bmish merged commit 3d4b160 into main Jan 1, 2026
9 checks passed
@bmish bmish deleted the rule-doc-title-desc-notice branch January 1, 2026 20:43
bmish pushed a commit that referenced this pull request Jan 1, 2026
🤖 I have created a release *beep* *boop*
---


##
[3.0.0](v2.4.0...v3.0.0)
(2026-01-01)


### ⚠ BREAKING CHANGES

* update default rule doc title and notices to separate rule name and
description
([#835](#835))
* Add default emoji for `base` config
* Remove implicit config badge fallback
* Require Node 20, 22, 24+

### Features

* Add default emoji for `base` config
([c3f1fb9](c3f1fb9))
* Remove implicit config badge fallback
([654667c](654667c))
* Require Node 20, 22, 24+
([af5ab75](af5ab75))
* update default rule doc title and notices to separate rule name and
description
([#835](#835))
([3d4b160](3d4b160))
* update dependencies
([#834](#834))
([828d6cf](828d6cf))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update default rule doc title format and show description notice by default

1 participant