"Create your app": .sln/.slnx step and Solution Explorer instructions don't match current C# Dev Kit

Open Beginner friendly
  • Is something wrong?
#1,844 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
csharp, vscode
Domain
documentation

Research direction

The problem is in the Blazor tutorial's "Create your app" page, so the text and video for step 7 and the Solution Explorer section are the files to change. First confirm in VS Code with C# Dev Kit 3.40 that the Explorer and "C# Project Details" views show what the issue describes. Done means the step wording and the Solution Explorer section match the current UI, and the .sln prompt step is removed or reworded.

Written by the indexing model from the issue text.

Description

area-tutorials needs-triage
URL

https://dotnet.microsoft.com/en-us/learn/aspnet/blazor-tutorial/intro

Operating system

windows

More information about your system
  • OS: Windows 10 (Windows_NT x64 10.0.19045), x64
  • VS Code 1.144.1 (user setup)
  • C# Dev Kit 3.40.215
  • C# extension 2.160.4
  • .NET SDK 10.0.403
Description

The "Create your app" page no longer matches the current VS Code / C# Dev Kit experience:

  1. The step "If you see both .sln and .slnx files, choose the .sln file" never appears. The C# Dev Kit log shows the extension runs dotnet new sln -n BlazorApp -f sln directly and creates only BlazorApp.sln, so there is no prompt.

  2. The page asks the reader to open "Solution Explorer" in the Side Bar and drag it below BlazorApp. In C# Dev Kit 3.40.215 there is no Solution Explorer view. It was merged into the VS Code Explorer, and a "C# Project Details" view now shows the virtual project items (Analyzers, Dependencies, Packages).

Expected: the steps and the video match what the reader sees.
Actual: I spent a long time troubleshooting (account sign-in, extension logs, window reloads) looking for a view that no longer exists.

Suggested fix: update step 7 and the Solution Explorer section (text and video) to describe the Explorer plus "C# Project Details".

dotnet --info

SDK DE .NET:
Version: 10.0.403
Commit: 5a2162bea6
Workload version: 10.0.400-manifests.a00bebb6
MSBuild version: 18.9.15+5a2162bea

Entorno de tiempo de ejecución:
OS Name: Windows
OS Version: 10.0.19045
OS Platform: Windows
RID: win-x64
Base Path: C:\Program Files\dotnet\sdk\10.0.403\

Cargas de trabajo de .NET instaladas:
No hay cargas de trabajo instaladas para mostrar.
Configurado para usar workload sets al instalar nuevos manifiestos.
No hay conjuntos de cargas de trabajo instalados. Ejecute "dotnet workload restore" para instalar un conjunto de carga de trabajo.

Host:
Version: 10.0.14
Architecture: x64
Commit: 0427b9abbe

.NET SDKs installed:
8.0.427 [C:\Program Files\dotnet\sdk]
10.0.103 [C:\Program Files\dotnet\sdk]
10.0.302 [C:\Program Files\dotnet\sdk]
10.0.401 [C:\Program Files\dotnet\sdk]
10.0.402 [C:\Program Files\dotnet\sdk]
10.0.403 [C:\Program Files\dotnet\sdk]

.NET runtimes installed:
Microsoft.AspNetCore.App 8.0.33 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.3 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.12 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.13 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.14 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.NETCore.App 6.0.31 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 8.0.33 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.3 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.12 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.13 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.14 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.WindowsDesktop.App 6.0.31 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 8.0.33 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 10.0.3 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 10.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 10.0.12 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 10.0.13 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 10.0.14 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]

Other architectures found:
None

Environment variables:
Not set

global.json file:
Not found

Learn more:
https://aka.ms/dotnet/info

Download .NET:
https://aka.ms/dotnet/download

Dominant language
No language data
Stars
7
Forks
57
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

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.

More from dotnet/website-feedback

All issues in dotnet/website-feedback

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.