Skip to content

docs: add issue title naming convention#570

Merged
rdmueller merged 2 commits into
LLM-Coding:mainfrom
JensGrote:docs/issue-title-convention-564
Jun 2, 2026
Merged

docs: add issue title naming convention#570
rdmueller merged 2 commits into
LLM-Coding:mainfrom
JensGrote:docs/issue-title-convention-564

Conversation

@JensGrote
Copy link
Copy Markdown
Collaborator

@JensGrote JensGrote commented Jun 2, 2026

Summary

Implements the naming convention agreed upon in #564.

Changes

  • CONTRIBUTING.adoc / .md / docs/CONTRIBUTING.de.adoc: New "Issue Title Convention" section documenting the recognized [Type]: <Name> prefixes and guidelines (apply going forward only, EPIC as sanctioned exception).
  • .github/ISSUE_TEMPLATE/contract-proposal.yml: New template for [Contract Proposal]: issues.
  • .github/ISSUE_TEMPLATE/process-proposal.yml: New template for [Process Proposal]: issues.

What was NOT included (by design)

  • No retro-renaming of closed issues.
  • No title-lint GitHub Action yet (can be added later as a non-blocking warning).
  • No templates for rarely-used types (Role, Category, Metadata) — YAGNI.

Tested

  • YAML lint: both new templates pass validation.
  • All three CONTRIBUTING variants (EN AsciiDoc, EN Markdown, DE AsciiDoc) updated consistently.

Closes #564

Summary by CodeRabbit

Release Notes

  • Dokumentation

    • Neue "Issue Title Convention" Richtlinien eingeführt mit konsistenten Titel-Formaten und anerkannten Präfixen wie [Contract Proposal], [Process Proposal], [Bug] und EPIC:
  • Chores

    • Neue GitHub-Issue-Templates für Contract und Process Proposals bereitgestellt mit strukturierten Formularen für standardisierte Eingaben

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 2, 2026

Review Change Stack

Warning

Review limit reached

@JensGrote, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 22 minutes and 23 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: d2c18f52-6911-4646-8395-538a39f6cd79

📥 Commits

Reviewing files that changed from the base of the PR and between fb54861 and 1d09896.

📒 Files selected for processing (2)
  • CONTRIBUTING.adoc
  • docs/CONTRIBUTING.de.adoc

Walkthrough

Das Pull Request führt eine konsistente Namengebung für Issue-Titel ein: neue GitHub Issue-Templates für Vertrags- und Prozessvorschläge definieren Titelprä­fixe und Formularfelder, während erweiterte Beitragrichtlinien in Deutsch und Englisch die Konvention dokumentieren und Guidelines zur Anwendung bereitstellen.

Changes

Issue-Titel-Konvention und Templates

Layer / File(s) Zusammenfassung
GitHub Issue-Templates für Contract und Process Proposals
.github/ISSUE_TEMPLATE/contract-proposal.yml, .github/ISSUE_TEMPLATE/process-proposal.yml
Zwei neue GitHub Issue-Templates definieren strukturierte Formulare mit automatisierten Titelprä­fixen für Vertrag- und Prozessvorschläge, einschließlich Metadaten, Pflichtfelder und Validierungen.
Dokumentation der Issue-Titel-Konvention
CONTRIBUTING.adoc, CONTRIBUTING.md, docs/CONTRIBUTING.de.adoc
Erweiterte Beitragrichtlinien in drei Dokumentversionen dokumentieren das einheitliche Titelmuster [Typ]: <Name>, eine Tabelle mit anerkannten Präfixen (z. B. [Anchor Proposal]:, [Contract Proposal]:, [Bug]:, [Feature]:, [Process Proposal]:, EPIC:) und Guidelines zur Anwendung, einschließlich Richtlinien für Template-basierte und freie Issues sowie der Regel „nur zukunftsbezogen".

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 Minuten

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Der Titel beschreibt die Hauptänderung prägnant: Dokumentation einer Issue-Titel-Konvention, was dem Kern der Änderungen entspricht.
Linked Issues check ✅ Passed Der Pull Request erfüllt alle wesentlichen Anforderungen aus Issue #564: Issue-Templates wurden hinzugefügt, Konvention in CONTRIBUTING-Dokumenten dokumentiert.
Out of Scope Changes check ✅ Passed Alle Änderungen sind direkt auf die Anforderungen von Issue #564 ausgerichtet; keine außerhalb des Scopes gelegenen Änderungen identifiziert.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CONTRIBUTING.adoc`:
- Around line 315-318: Replace the Markdown list markers (`-`) with AsciiDoc
unordered-list markers (`*`) for the four bullet lines that start with "Use the
issue template...", "Free-form issues...", "Apply going forward only...", and
"EPICs use the bare `EPIC:`..." so the block uses AsciiDoc syntax; keep the text
unchanged aside from the leading marker and ensure there is a blank line before
the list if needed for proper AsciiDoc rendering.

In `@docs/CONTRIBUTING.de.adoc`:
- Around line 228-231: Replace the hyphen list markers with AsciiDoc unordered
list markers in the German CONTRIBUTING doc: change the four list items
currently starting with "-" to start with "*" so the lines beginning with
"Verwenden Sie das Issue-Template", "Frei formulierte Issues", "Nur zukünftig
anwenden" and "EPICs verwenden das bloße `EPIC:` Prefix" use AsciiDoc's
unordered marker `*` (not Markdown `-`) to conform to the "*.adoc" guideline.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 72f8b38c-ef29-47bc-aeff-181dbd59ba5d

📥 Commits

Reviewing files that changed from the base of the PR and between 2e8dfc4 and fb54861.

📒 Files selected for processing (5)
  • .github/ISSUE_TEMPLATE/contract-proposal.yml
  • .github/ISSUE_TEMPLATE/process-proposal.yml
  • CONTRIBUTING.adoc
  • CONTRIBUTING.md
  • docs/CONTRIBUTING.de.adoc

Comment thread CONTRIBUTING.adoc Outdated
Comment thread docs/CONTRIBUTING.de.adoc Outdated
@rdmueller rdmueller merged commit 421f066 into LLM-Coding:main Jun 2, 2026
7 checks passed
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.

[Process Proposal]: Consistent issue title naming convention

2 participants