dotnet / dotnet/docs

Roslyn components multi-targeting needs to be documented

Open
#27,943 4 comments 0 reactions 0 assignees View on GitHub
dotnet-csharp/svc roslyn-sdk/subsvc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
15h 21m
Merged PRs (30d)
370

Description

The work done in https://github.com/dotnet/sdk/pull/20793 should be documented. Points that should be covered:

- Why/when multi-targeting is needed.
- How to include different versions in both cases when SDK supports components multi-targeting (`SupportsRoslynComponentVersioning` is true) and when it's false.
- How to handle Roslyn APIs that exists in a newer version but not an older one.

The article can go in https://github.com/dotnet/docs/tree/main/docs/csharp/roslyn-sdk and be linked from source generators article and analyzer/codefix article.

cc @eerhardt in case you want to work on the documentation.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.