Show real case scenario examples for many common cases in Roslyn APIs #35924
Description
Inspired by lately finding out that SymbolDisplay.ToDisplayString(ISymbol, SymbolDisplayFormat?) displays an INamespaceSymbol representing the namespace "A.B.C.D" as A.B.C.D, not just its name which is D.
There are many more examples of docs that briefly describe the abstractions and how they are functioning, without clarifying the behavior in real and common scenarios, without having to have first experimented by manually running the theoretical code.
The common motivation for this is the confidence in writing that piece of code for the Roslyn components in applications, and not fearing that an API might not find suit, resulting in reinventing the wheel even for the most basic needs.
Below is the generated section for the initial docs page that inspired this.
Document Details
⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.
- ID: 3af8ea41-d247-a93d-0195-33c8f06ca7b5
- Version Independent ID: 5a952dfa-3b84-d850-d908-837b85448ec0
- Content: SymbolDisplay.ToDisplayString Method (Microsoft.CodeAnalysis.CSharp)
- Content Source: dotnet/xml/Microsoft.CodeAnalysis.CSharp/SymbolDisplay.xml
- Product: dotnet-roslyn-api
- Technology: microsoft.codeanalysis
- GitHub Login: @dotnet-bot
- Microsoft Alias: dotnetcontent