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

SYSLIB1219 (and placeholder SYSLIB1218) missing from the options-validation source-generator diagnostics reference

Cerrado Apto para principiantes
#56,285 1 comentario 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
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
csharp

Línea de trabajo

Abre docs/fundamentals/syslib-diagnostics/syslib1201-1219.md e inspecciona la tabla de diagnósticos existente y el front matter. Verifica SYSLIB1219 con Microsoft.Extensions.Options/gen/DiagDescriptors.cs y, a continuación, confirma con el equipo de runtime el tratamiento previsto para SYSLIB1218, que está reservado. El trabajo estará terminado cuando la referencia y las palabras clave reflejen con precisión los diagnósticos admitidos.

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

Descripción

:watch: Not Triaged

Description

The options-validation source-generator diagnostics reference page's front matter (f1_keywords) already lists syslib1218 and syslib1219, but the description table only documents SYSLIB1201-SYSLIB1217. Two diagnostic IDs are undocumented:

  • SYSLIB1219 (AlreadyImplementsValidateAsyncMethod) - a new diagnostic introduced with async options-validation source generation (ValidateAsync emission for IAsyncValidateOptions<TOptions>), defined in DiagDescriptors.cs. It's the async counterpart to the existing SYSLIB1205 (AlreadyImplementsValidateMethod): the generator reports it when an attributed type already provides a handwritten ValidateAsync method matching the generated signature.
  • SYSLIB1218 - reserved as a keyword but not currently defined by any diagnostic descriptor in the Options source generator. Needs confirmation of intent (reserved for future use vs. removable from front matter).

Repro / evidence

  • Front matter lists both IDs: syslib1201-1219.md front matter
  • Table stops at SYSLIB1217: no rows for 1218/1219.
  • SYSLIB1219 diagnostic descriptor: Microsoft.Extensions.Options/gen/DiagDescriptors.cs, id: "SYSLIB1219", message SR.AlreadyImplementsValidateAsyncMethodMessage.

Suggested content

Add a table row:

Diagnostic ID Description
SYSLIB1219 A type already includes an implementation of the ValidateAsync method.

And either:

  • Add a SYSLIB1218 row once its purpose is confirmed with the runtime team, or
  • Remove syslib1218 from f1_keywords if it's unused/reserved and not meant to surface publicly yet.

Type of gap

Not a breaking change - SYSLIB1219 is a new diagnostic tied to a new generator capability (async Validate generation), not a change to previously working behavior. This is a plain content gap in an existing reference page.

Related

  • Async options-validation source generation: dotnet/runtime#130263
  • Related (already-addressed) breaking-change doc for the async validation contract unification: dotnet/docs#55794 / dotnet/docs#55901 (unrelated to this diagnostic gap)

This issue was drafted with assistance from GitHub Copilot.

Lenguaje dominante
Sin datos de lenguaje
Estrellas
4.8k
Forks
6.1k
Merge medio
17 h 56 min
PR fusionados (30 d)
214

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

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 dotnet/docs

Todos los issues de dotnet/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.