Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

General issues with discoverability of information

Ouverte
#2,908 2 commentaires 1 réaction 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
25/100
Type d'issue
Fonctionnalité
Clarté
À clarifier
Activité
À l'abandon
Stack technique
typescript
Domaine
documentation, search

Piste de recherche

Commencez sur https://www.typescriptlang.org/ et examinez le comportement de recherche du site pour « assert » et « asserts », puis comparez-le à la section « Assertion Functions » de la page de narrowing liée. La tâche est considérée comme terminée lorsque le contenu référencé par l’issue, y compris les informations pertinentes de « What’s New », peut être trouvé grâce à la recherche du site.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.

Langage dominant
TypeScript
Étoiles
2.6k
Forks
1.5k
Merge moyen
2 j 12 h
PR mergées (30 j)
8

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de microsoft/TypeScript-Website

Toutes les issues de microsoft/TypeScript-Website

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.