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

docs(breg): configure/breg.mdx lists stages for a request_lifecycle when, which bregctl refuses

オープン 初心者向け
#1,574 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
92/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
rust
領域
documentation

調査の方向性

docs/site/src/content/docs/configure/breg.mdx の hooks メンバーテーブルにある when 行から始めます。registry-project.v1alpha1.schema.json と、引用されている change_request.rs テストを確認し、サポートされている request_lifecycle メンバーを確定します。ドキュメントから stages を削除し、その後 bregctl check で例を検証して、行に transitions と toStates だけが記載されていることを確認します。

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

説明

agent-ready area:breg area:docs criticality:p3 documentation triage:needs-implementation

docs/site/src/content/docs/configure/breg.mdx (hooks member table, when row) says a kind: request_lifecycle test takes transitions, toStates, and stages. On v0.34.0 and current main, stages is not an accepted member:

  • registry-project.v1alpha1.schema.json has only kind, toStates and transitions for the request_lifecycle form of when.
  • crates/registry-breg/src/change_request.rs has the test obsolete_stages_and_application_modes_are_not_authoring_inputs.
  • bregctl check refuses it:
# products/breg nursing-register example, with this added to the request_lifecycle hook:
#   "when": {"kind": "request_lifecycle", "stages": ["review"]}
$ bregctl check <copy> --format json | jq -c '.diagnostics[] | {code, message}'
{"code":"source.yaml.invalid","message":"the YAML source is structurally invalid: entities[1].hooks[0]: unknown field `stages`, expected `transitions` or `toStates` at line 382 column 9"}

The same hook with "toStates": ["submitted"] passes. Suggested fix: drop , and stages from that row (with transitions and toStates).

Found by bregctl 0.34.0 while auditing breg-skills against the vendored docs.

主要言語
Rust
スター
2
フォーク
0
平均マージ
7時間 46分
マージ済み PR(30日)
199

環境構築

はじめの一歩

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

registrystack/registry-stack のほかの issue

registrystack/registry-stack の issue をすべて見る

似ている issue

Rust の issue をもっと見る

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

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