Skip to content

docs: fix subject-case rule default from 'always' to 'never'#4703

Merged
escapedcat merged 1 commit intoconventional-changelog:masterfrom
Chessing234:docs/fix-subject-case-docs-4587
Apr 7, 2026
Merged

docs: fix subject-case rule default from 'always' to 'never'#4703
escapedcat merged 1 commit intoconventional-changelog:masterfrom
Chessing234:docs/fix-subject-case-docs-4587

Conversation

@Chessing234
Copy link
Copy Markdown
Contributor

Summary

  • Fixes the subject-case rule documentation in docs/reference/rules.md which incorrectly stated the default rule as always instead of never
  • The actual default in @commitlint/config-conventional is never with the value ['sentence-case', 'start-case', 'pascal-case', 'upper-case'], meaning subjects must not be in those cases
  • The @commitlint/config-conventional README already correctly documents this as never

Fixes #4587

Test plan

  • Verified the actual default in @commitlint/config-conventional/src/index.ts is "never"
  • Verified the @commitlint/config-conventional README already says never
  • Updated docs/reference/rules.md to match

🤖 Generated with Claude Code

The documentation for the subject-case rule incorrectly stated the
default rule as 'always', but the actual default in
@commitlint/config-conventional is 'never'.

Fixes #4587

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
@qodo-code-review
Copy link
Copy Markdown

Review Summary by Qodo

Fix subject-case rule default documentation

📝 Documentation

Grey Divider

Walkthroughs

Description
• Corrects subject-case rule default from always to never
• Aligns documentation with actual @commitlint/config-conventional implementation
Diagram
flowchart LR
  A["docs/reference/rules.md"] -- "Update rule default" --> B["subject-case: never"]
Loading

Grey Divider

File Changes

1. docs/reference/rules.md 📝 Documentation +1/-1

Fix subject-case rule default value

• Changed subject-case rule default from always to never
• Corrects documentation to match actual implementation in @commitlint/config-conventional

docs/reference/rules.md


Grey Divider

Qodo Logo

@qodo-code-review
Copy link
Copy Markdown

qodo-code-review Bot commented Apr 6, 2026

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

ⓘ The new review experience is currently in Beta. Learn more

Grey Divider

Qodo Logo

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the commitlint rules reference documentation to correctly reflect the default behavior of the subject-case rule, aligning docs/reference/rules.md with the actual default in @commitlint/config-conventional and resolving the mismatch reported in #4587.

Changes:

  • Corrected the documented default subject-case rule from always to never in the rules reference.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@escapedcat
Copy link
Copy Markdown
Member

Thanks!

@escapedcat escapedcat merged commit e9ddb72 into conventional-changelog:master Apr 7, 2026
19 checks passed
This was referenced Apr 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

docs: subject-case in docs does not match default

3 participants