Skip to content

Improve F1 help for tokens with multiple uses #48392

@davidwengier

Description

@davidwengier

There are a number of keywords and tokens in C# that have different meanings based on context and in a lot of cases our F1 documentation doesn't draw any distinction between different usages, despite there being docs pages written for each use.

This work would be done in conjunction with, or after dotnet/docs#20799 has been completed, to ensure unique f1_keyword metadata is present in the docs pages, and then update Roslyn to send the correct f1_keyword in the right context.

Rather than log issues about each individual token, dotnet/docs#20799 should be used as a checklist of items to work through. Anyone contributing fixes in this area should do so only after the docs have been updated accordingly, or should open a PR in the docs repo at the same time.

For example, the ! token was ambiguous in the docs so first dotnet/docs#20341 was created to fix the documentation and then #47516 was created to fix Roslyn. These two PRs form a very good basis for future work.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    Status

    Completed

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions