Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

docs(release): der Release-Text braucht eine kuratierte deutsche Zusammenfassung

Đang mở
  • Có gì không ổn?
#454 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
csharp, github-actions, yaml
Lĩnh vực
ci-cd, documentation, release

Hướng nghiên cứu

Read the release workflow in release.yml, how it assembles release-notes.md, and the existing CHANGELOG.md check. Decide whether the German summary is handwritten or generated, where it lives, and how a missing summary should block a final release; the issue leaves these design choices open. Done means the release process includes a curated German summary and validates its presence.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

documentation i18n

Befund

#447 hatte zwei Hälften. Die erste — CHANGELOG.md bekommt eine Sprache, eine Form und eine Prüfung — ist mit #453 erledigt: Englisch, ein Satz pro Eintrag, jeder Eintrag mit Link auf seinen Pull Request.

Die zweite steht noch. Der Release-Text verlinkt heute nur CHANGELOG.md (#369). Wer über „Downloads" kommt, landet damit auf 43 englischen Aufzählungspunkten, von denen der erste von Path.Join handelt.

Was gebraucht wird

Ein kuratierter deutscher Release-Text, ~5 Sätze, für den Kommandanten, der von der Download-Seite kommt — nicht generiert, nicht vollständig:

Der Sicherheitstrupp wird erfasst. Die CO-Messreihe bleibt erhalten. Der Android-APK kann endlich beitreten.

CHANGELOG.md bleibt vollständig und englisch. Die beiden widersprechen sich nicht: das eine ist der Nachweis, das andere die Ansage.

Warum nicht „jeder Eintrag auf de und en"

Zwei Fragmente pro Pull Request heißt, die Sicherheitstrupp-Beschreibung wird um 23:00 nach der Übung ein zweites Mal geschrieben. Was entsteht, ist die deutsche Fassung plus TODO: übersetzen, und ein halbes Jahr später steht dort eine veraltete Übersetzung, die mit voller Überzeugung etwas Falsches behauptet. AGENTS.md kennt dieses Versagen bereits — die Regel, README und Website im selben PR-Paar zu ändern, existiert genau deshalb.

Zu entscheiden

  1. Geschrieben oder erzeugt? Fünf Sätze pro Release von Hand sind billig und lesen sich besser als alles Generierte. Dagegen spricht nur, dass sie vergessen werden können — was der version-Job in release.yml prüfen könnte, so wie er heute schon eine fehlende CHANGELOG.md-Sektion ablehnt.
  2. Falls erzeugt: eine zusätzliche Markierung „betrifft eine Einsatzkraft" am Fragment genügt, um den deutschen Text aus dieser Teilmenge zu ziehen, ohne die Prosa zu verdoppeln. towncrier sortiert Fragmente bereits nach Typ; ein siebter Typ oder ein Namenszusatz wäre der Ort dafür.
  3. Wo steht der Text? Im Release-Body direkt (release-notes.md in release.yml baut ihn ohnehin zusammen), oder als eigene Datei im Repo, die der Workflow einliest.

Mein Vorschlag ist 1 mit einer Prüfung: von Hand geschrieben, aber ein finales Release ohne den Text wird abgelehnt, bevor Build-Minuten ausgegeben werden.

Passt thematisch zu v0.10 — i18n and architecture; Meilenstein bewusst offen gelassen.

Zweite Hälfte von #447, abgetrennt beim Umsetzen der ersten in #453.

🤖 Generated with Claude Code

Ngôn ngữ chính
C#
Star
1
Fork
3
Merge trung bình
4 giờ 34 phút
Pull request đã merge (30 ngày)
182

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của CodeForFire/lagebuch

Tất cả issue của CodeForFire/lagebuch

Issue tương tự

Thêm issue về C#

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.