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

Documentation does not explain what generics represent

Abierto Apto para principiantes
#22,121 5 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
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
68/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
typescript

Línea de trabajo

Comienza con la entrada MatDatepickerInputEvent en la documentación de la API del datepicker de Angular Material e inspecciona cómo se presenta su declaración de TypeScript. Documenta qué representan los parámetros de tipo S y D, siguiendo el estilo para parámetros de tipo mostrado en la documentación de Java enlazada. Se considera terminado cuando las personas nuevas en el proyecto pueden entender ambos genéricos a partir de la documentación de la API.

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

Descripción

area: dev-infra docs P2
Documentation Feedback

In docs it would be helpful to have documentaion for declared TS generics.
For example, I open MatDatepickerInputEvent docs and see S and D generics.
And from the docs it's unclear what these S and D represent!

I think it should be documented similar to as Java does it.
For example, a docs of Java's standard type Function<T,​R> contain a section

Type Parameters:
T - the type of the input to the function
R - the type of the result of the function

Lenguaje dominante
TypeScript
Estrellas
25k
Forks
6.8k
Merge medio
1 d 7 h
PR fusionados (30 d)
92

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 angular/components

Todos los issues de angular/components

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.