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(breg): configure/breg.mdx lists stages for a request_lifecycle when, which bregctl refuses

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#1,574 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ó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
92/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
rust
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu tại docs/site/src/content/docs/configure/breg.mdx, ở bảng các thành viên hooks và hàng when của bảng. Kiểm tra registry-project.v1alpha1.schema.json và test change_request.rs được trích dẫn để xác nhận các thành viên request_lifecycle được hỗ trợ. Xóa stages khỏi tài liệu, sau đó xác minh ví dụ bằng bregctl check và đảm bảo hàng này chỉ liệt kê transitions và toStates.

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

Mô tả

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.

Ngôn ngữ chính
Rust
Star
2
Fork
0
Merge trung bình
5 giờ 13 phút
Pull request đã merge (30 ngày)
176

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 registrystack/registry-stack

Tất cả issue của registrystack/registry-stack

Issue tương tự

Thêm issue về Rust

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.