[Roslyn] Tutorial misses information about netCore3.0 (unsupported!) is required to be installed to use the Roslyn .NET Standard Template and succeed with the tutorial

オープン
#50,386 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
50/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
停滞
技術スタック
csharp

調査の方向性

docs/csharp/roslyn-sdk/tutorials/how-to-write-csharp-analyzer-code-fix.md から始め、プロジェクトとターゲット フレームワークに関する説明を、現在の Roslyn SDK テンプレートおよび Visual Studio Installer コンポーネントと比較します。必要なコンポーネントを文書化し、プロジェクト ターゲット netstandard2.0、netcoreapp3.1、net472 について、トラブルシューティングまたは移行のガイダンスを追加します。チュートリアルが現在のテンプレート エクスペリエンスを反映していることを確認します。

索引モデルが issue の本文から書いたものです。

説明

dotnet-csharp/svc roslyn-sdk/subsvc
Type of issue

Missing information

Description

I attempted to create my first Roslyn Generator/Analyzer Project from scratch in VS2026 v18.0.2 using the linked tutorial guide, but just like the user here:

(which should be fixed from the issue state !!! )

and latest updates and workloads provided from the Visual Studio Installer, I run into the same problems:

  • We can not select to get a "real" .NET Standard Project, only be able to choose between different .NET Framework Versions but we not can "opt-out" of using NET Framework.
  • Analyzer (main project), Analyzer.Codefixes, Analyzer.Package Projects are using the to be expected <TargetFramework>netstandard2.0</TargetFramework> in .csproj that doesn't applies on the two other provided Projects!
  • Analyzer.Test is provided with the expected to be fixed and by that not included <TargetFramework>netcoreapp3.1</TargetFramework>
  • Analyzer.Vsix is provided with the previously required to be selected <TargetFramework>net472</TargetFramework>

There is exactly NO Information about both (Framework / .NET Core) installation Components would be required for this tutorial or using the Roslyn SDK Templates, I would ask you to add those critical information into this Documentation and, if you have some, also to suggest to us, how to workaround this or similar. But saying nothing and just awaiting the user to get a bad User Expirience is the worst approach I can think of 👀
and I am sure, that's not your intention 👍

This is the current User Expirience you are providing to us without any changes:

https://github.com/user-attachments/assets/55ed18de-a600-4d63-82dd-4dfa351d89c2

Since the linked sample is not using these issued TFM's, I think someone is aware of this update requirement in your Team and maybe even if you are not the ones relyable for the Tempaltes provided, you could possibly add a kind of migration/Troubleshooting section for this?
Thanks in advance!

Additional Information & Feedback

I did hear already from the requirement to be using netstandard2.0 even if I am not very happy about it, because we are now for regular apps at .NET 10, that would be okay and expected.
Even Visual Studio Installer itself is stating .NET Core 3.1-Runtime as not longer supported so the priority of anyone who is maybe relyable in shipping VS Templates should maybe re-evaluated 😄 :

Image
Page URL

https://learn.microsoft.com/en-us/dotnet/csharp/roslyn-sdk/tutorials/how-to-write-csharp-analyzer-code-fix

Content source URL

https://github.com/dotnet/docs/blob/main/docs/csharp/roslyn-sdk/tutorials/how-to-write-csharp-analyzer-code-fix.md

Document Version Independent Id

a286e20b-1e43-dc57-e0fb-5a9dee7ec3f6

Platform Id

66b66ae2-c045-6e7a-3fc2-550b1ac424ee

Article author

@BillWagner

Metadata
  • ID: 6e3fc905-7aa1-7f5e-9bfe-fbcef461ad5e
  • PlatformId: 66b66ae2-c045-6e7a-3fc2-550b1ac424ee
  • Service: dotnet-csharp
  • Sub-service: roslyn-sdk

Related Issues

主要言語
言語のデータがありません
スター
4.8k
フォーク
6.1k
平均マージ
22時間 46分
マージ済み PR(30日)
296

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

dotnet/docs のほかの issue

dotnet/docs の issue をすべて見る

似ている issue

Compilers の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。