microsoft / microsoft/TypeScript

Show documentation for literals in intellisense

Open
#31,769 1 comment 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Awaiting More Feedback Suggestion
Dominant language
Go
Stars
111k
Forks
14.3k
Avg merge
2d 4h
Merged PRs (30d)
132

Description

Suggestion

When filling in a value where the expected type is a union of literals, intellisense is able to suggest the possible values.

However, it does NOT show the documentation associated with each literal:

image

This makes me tend to use enums instead, which has a more verbose syntax and requires an extra import.

Use Cases

Building and documented APIs in typescript will be nicer if we could just document the literals in a union.

Search Terms

  • intellisense for string literals
  • documentation for string literals

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing IntelliSense completion for a union of documented string literals in TypeScript. Trace the completion and documentation behavior for literal suggestions, then verify that each suggested literal displays its associated documentation without changing enum behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
developer-experience, tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.