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

General issues with discoverability of information

Abierto
#2,908 2 comentarios 1 reacción 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Estancado
Stack tecnológico
typescript
Área
documentation, search

Línea de trabajo

Comienza en https://www.typescriptlang.org/ e inspecciona el comportamiento de búsqueda del sitio web para “assert” y “asserts”; después, compáralo con la sección “Assertion Functions” de la página de narrowing enlazada. Se considera que la tarea está terminada cuando el contenido referenciado por el issue, incluida la información relevante de “What’s New”, se puede encontrar mediante la búsqueda del sitio.

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

Descripción

Page URL: https://www.typescriptlang.org/

Issue: The website search does not include any "What's New" sections.

Yes, this could result in outdated or duplicate content in search, however, there is currently no way to find any important features that aren't listed elsewhere. Searching for "assert" or even "asserts" does not bring up any information about the "asserts" keyword. Even searching for "assertion does not find this section https://www.typescriptlang.org/docs/handbook/2/narrowing.html#assertion-functions here. So perhaps there are just bugs with searching in general? I'm not really sure.

A more long term solution would be to provide a community editable wiki, something akin to cppreference, tsreference dot com if you will. You might be uncomfortable with not having direct authority over all the edits made, but I believe it would be an improvement on the status quo. If you're not willing to hire dedicated maintainers for the official site, then you might as well provide a platform for others to do the job for you. You can't have your cake and eat it too unfortunately.

This would lift a lot of the burden of writing the handbook as well. It wouldn't be so crippling to be missing newer information from it when there's always a bleeding edge reference that one can look to. The handbook's purpose gets freed up as a beginner resource instead of a catch-all resource. Microsoft can be satisfied they are only publishing approved ideas of the language, the TS team doesn't have as much pressure from the community to focus on it, and new information is still more accessible than it was before.

Lenguaje dominante
TypeScript
Estrellas
2.6k
Forks
1.5k
Merge medio
2 d 12 h
PR fusionados (30 d)
8

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

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 microsoft/TypeScript-Website

Todos los issues de microsoft/TypeScript-Website

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.