microsoft / microsoft/TypeScript

Document behavior, gotchas, etc, for public TypeChecker API

Abierto
#53,239 6 comentarios 4 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Docs Domain: API
Lenguaje dominante
Go
Estrellas
111k
Forks
14.4k
Merge medio
1 d 19 h
PR fusionados (30 d)
117

Descripción

A common (valid) complaint about our public API is that we don't have any documentation for what the methods do, why to use them, why not to use them, the gotchas, etc.

In more recent API PRs (like #52467 and #52473), we've added descriptions, but we should do the same for the existing methods if possible.

Guía de contribución

Abrir la guía de contribución

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.

Línea de trabajo

Empieza revisando las descripciones añadidas en los PRs #52467 y #52473; después, identifica los métodos públicos existentes de TypeChecker que carecen de una documentación comparable. Documenta qué hace cada método, cuándo usarlo, cuándo no usarlo y cuáles son sus particularidades; se considerará terminado cuando la API existente tenga descripciones útiles en toda su extensión.

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

Evaluación

Stack tecnológico
typescript
Área
compilers, documentation
Tipo de issue
Documentación
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.