Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#1,574 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
92/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
rust
Área
documentation

Línea de trabajo

Comienza en docs/site/src/content/docs/configure/breg.mdx, en la tabla de miembros de hooks y su fila when. Comprueba registry-project.v1alpha1.schema.json y el test change_request.rs citado para confirmar los miembros de request_lifecycle compatibles. Elimina stages de la documentación, luego verifica el ejemplo con bregctl check y asegúrate de que la fila enumere únicamente transitions y toStates.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Rust
Estrellas
2
Forks
0
Merge medio
5 h 13 min
PR fusionados (30 d)
176

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de registrystack/registry-stack

Todos los issues de registrystack/registry-stack

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.