Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン
  • 何か問題がありますか？
#454 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
csharp, github-actions, yaml
領域
ci-cd, documentation, release

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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

主要言語
C#
スター
1
フォーク
3
平均マージ
4時間 34分
マージ済み PR（30日）
182

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

CodeForFire/lagebuch のほかの issue

CodeForFire/lagebuch の issue をすべて見る

似ている issue

C# の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。