-
Notifications
You must be signed in to change notification settings - Fork 6.1k
Rework interactive tutorials #50347
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Rework interactive tutorials #50347
Conversation
First edit pass on tuples and types.
First edit pass updating the branches and loops tutorial.
Convert all code from this sample to file-based apps.
d611b78 to
947157c
Compare
|
This is ready for review, but not ready to merge. I'm waiting on creating the official codespace repo for these introductory tutorials. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
This PR reimagines the interactive C# tutorials by replacing Try.NET with a GitHub Codespaces-based approach using file-based apps. Instead of running code in an in-browser interactive window, users now create files in GitHub Codespaces and execute them using dotnet commands in a terminal.
Key Changes:
- Migrated all tutorial content from Try.NET interactive snippets to GitHub Codespaces with file-based C# apps
- Consolidated code snippets into single executable .cs files (e.g.,
hello-world.cs,numbers.cs,tuples-types.cs) - Removed project files (.csproj) as tutorials now use file-based apps
- Updated instructions to guide users through creating and running code in Codespaces
Reviewed changes
Copilot reviewed 28 out of 28 changed files in this pull request and generated 14 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/csharp/tour-of-csharp/tutorials/index.md | Updated landing page to reference GitHub Codespaces instead of browser-based interactive experience |
| docs/csharp/tour-of-csharp/tutorials/hello-world.md | Converted from interactive tutorial to Codespaces-based tutorial with file creation and terminal execution instructions |
| docs/csharp/tour-of-csharp/tutorials/numbers-in-csharp.md | Reorganized to use file-based execution with methods; contains typos and duplicate content |
| docs/csharp/tour-of-csharp/tutorials/branches-and-loops.md | Converted to Codespaces approach with code refactoring into methods; has duplicate completion messages |
| docs/csharp/tour-of-csharp/tutorials/list-collection.md | Updated to use Codespaces with file-based execution; outdated description and command issue |
| docs/csharp/tour-of-csharp/tutorials/tuples-and-types.md | Converted to Codespaces format with file-based app approach; missing instructional context |
| docs/csharp/tour-of-csharp/tutorials/pattern-matching.md | Updated to use Codespaces and file-based execution with grammar issue |
| docs/csharp/tour-of-csharp/tutorials/snippets/HelloWorld/hello-world.cs | New consolidated code file replacing Program.cs |
| docs/csharp/tour-of-csharp/tutorials/snippets/NumbersInCsharp/Numbers.cs | Refactored code into multiple methods for better organization |
| docs/csharp/tour-of-csharp/tutorials/snippets/BranchesAndLoops/branches-loops.cs | Added new refactored code section with methods |
| docs/csharp/tour-of-csharp/tutorials/snippets/ListCollection/list.cs | New consolidated code file replacing Program.cs |
| docs/csharp/tour-of-csharp/tutorials/snippets/TuplesAndTypes/tuples-types.cs | New consolidated code file with incorrect variable names in output |
| docs/csharp/tour-of-csharp/tutorials/snippets/PatternMatching/patterns.cs | New consolidated code file replacing multiple separate files |
| *.csproj files | Deleted project files as tutorials now use file-based apps |
| Program.cs files | Removed old Program.cs files, replaced by new consolidated snippet files |
docs/csharp/tour-of-csharp/tutorials/snippets/TuplesAndTypes/tuples-types.cs
Outdated
Show resolved
Hide resolved
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Fixes #50331
Fixes #50381
Reimagine the interactive tutorials that used Try.NET to introduce developers to the .NET platform.
Based on dotnet/try#1285, instead of Try.NET, use file-based apps in .NET 10 and GitHub codespaces to introduce developers to the platform without requiring an installation.
The current text uses the .NET template for the codespace. That works, but has extra features, and I'm working to get a new codespace for a minimal install. In the meantime, if you want to try the tutorials with the minimal set of features, open this (public) repository in codespaces: https://github.com/BillWagner/learn-csharp-codespaces
Internal previews
ifstatements and loops - conditional logic tutorial