Skip to content

docs: document the pull request title convention#86

Merged
Reefact merged 1 commit into
mainfrom
claude/pr-title-conventions-2sykyf
Jul 10, 2026
Merged

docs: document the pull request title convention#86
Reefact merged 1 commit into
mainfrom
claude/pr-title-conventions-2sykyf

Conversation

@Reefact

@Reefact Reefact commented Jul 10, 2026

Copy link
Copy Markdown
Owner

Summary

This PR documents the conventions for pull request titles in the project, establishing clear guidance on how to title PRs based on their scope and intent. It updates the contributor guide, PR template, and project conventions file.

Type of change

  • Bug fix
  • New feature
  • Breaking change
  • Refactoring
  • Analyzer / diagnostic change
  • Tests
  • Documentation
  • Build / CI / tooling

Changes

  • Added comprehensive "Pull request titles" section to CONTRIBUTING.md with:
    • Explanation of why PR titles need their own convention (distinct from commits)
    • Core rules: English language, naming the whole PR, shape based on number of intentions
    • Distinction between single-intention PRs (mirror commit header format) and multi-intention PRs (plain descriptive title)
    • Guidance on issue references (description, not title) and breaking changes
    • Table of examples showing correct PR titles and their rationale
    • Table of anti-patterns with explanations of what is wrong
  • Updated .github/pull_request_template.md to reference the new PR title conventions and clarify where issue links belong
  • Updated CLAUDE.md to instruct on following the new PR title conventions from CONTRIBUTING.md

Testing

  • No testing needed

Documentation

  • README / doc/ updated

Related issues

https://claude.ai/code/session_01S4XHakMTBzuDo9C3Pnjbm5

@Reefact Reefact changed the title docs: document pull request title conventions docs: document the pull request title convention Jul 10, 2026
Commit messages had a convention; pull request titles had only "write it
in English". State the rule where the reviewer and the template can point
to it: the title names the whole request, mirrors the commit header when
the branch carries one intention, and uses a plain descriptive title when
it carries several, with issue references kept in the description.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S4XHakMTBzuDo9C3Pnjbm5
@Reefact Reefact force-pushed the claude/pr-title-conventions-2sykyf branch from fe9b562 to 814e400 Compare July 10, 2026 22:35
@Reefact Reefact merged commit 047ad07 into main Jul 10, 2026
11 checks passed
@Reefact Reefact deleted the claude/pr-title-conventions-2sykyf branch July 10, 2026 22:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants