Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 29, 2025

The Visual Basic async programming documentation was using an incorrect C# article as a reference and had an academic structure that didn't match the recommended tutorial approach. This PR completely restructures the VB.NET async article to follow the correct C# article format (https://learn.microsoft.com/en-us/dotnet/csharp/asynchronous-programming/) while using proper Visual Basic syntax throughout.

Key Changes

Complete structural overhaul:

  • Replaced the academic article structure with the practical breakfast-making tutorial approach
  • Changed from abstract concepts to concrete, progressive examples showing synchronous → simple async → concurrent async patterns
  • Removed the technical diagram section and replaced with hands-on code examples

VB.NET breakfast tutorial implementation:

  • Created comprehensive VB.NET breakfast code examples that mirror the C# tutorial structure
  • All code uses proper Visual Basic syntax: Task(Of T), Async Function, Await, Module, etc.
  • Progressive examples show the evolution from blocking synchronous code to efficient concurrent async code

Improved consistency and readability:

  • All explanatory text now uses VB.NET method names and syntax consistently
  • Replaced C#-style examples with idiomatic Visual Basic patterns
  • Added proper VB.NET exception handling examples
  • Updated all cross-references to use VB.NET conventions

Modern .NET alignment:

  • Updated code snippets to target .NET 8.0
  • Removed outdated references and aligned with current async/await best practices
  • Added comparison between Async/Await and ContinueWith patterns in VB.NET

Enhanced documentation format:

  • Converted all code snippets to the modern :::code format for better rendering
  • Fixed relative links to follow documentation standards
  • Added visual diagrams from the C# version to illustrate timing concepts
  • Included proper AI-generated content disclosure

The article now provides the same high-quality tutorial experience as the C# version but with proper Visual Basic syntax and conventions throughout, eliminating the confusion reported in issue #17731.

Fixes #17731.
Fixes #37289 (duplicate).


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.


Internal previews

📄 File 🔗 Preview link
docs/visual-basic/programming-guide/concepts/async/index.md Asynchronous programming with Async and Await (Visual Basic)

@dotnet-policy-service dotnet-policy-service bot added the okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings. label Aug 29, 2025
@Copilot Copilot AI changed the title [WIP] Code diagram shows C# but this is a VB.NET specific page Fix VB.NET async documentation to use VB-specific code examples and method names Aug 29, 2025
Copilot finished work on behalf of BillWagner August 29, 2025 16:01
@Copilot Copilot AI requested a review from BillWagner August 29, 2025 16:01
@BillWagner
Copy link
Member

@copilot You picked the wrong C# article as a source. Use the one referenced in this comment: #17731 (comment)

The correct article is this one: https://learn.microsoft.com/en-us/dotnet/csharp/asynchronous-programming/ You can reuse those images for the VB article as well.

Copy link
Contributor Author

Copilot AI commented Aug 29, 2025

@copilot You picked the wrong C# article as a source. Use the one referenced in this comment: #17731 (comment)

The correct article is this one: ht...

I've restructured the VB article to follow the correct C# article format using the breakfast tutorial approach. The article now uses the same progressive teaching structure (synchronous → simple async → concurrent async) but with proper VB.NET syntax throughout. All code examples have been converted to the breakfast metaphor with VB.NET conventions. Commit: 07fcef0

@Copilot Copilot AI changed the title Fix VB.NET async documentation to use VB-specific code examples and method names Restructure VB.NET async article to follow C# breakfast tutorial format with proper VB syntax Aug 29, 2025
Copilot finished work on behalf of BillWagner August 29, 2025 17:37
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is much closer. I have a few things to address and this will be ready.

@BillWagner
Copy link
Member

@copilot Please address the remaining comments.

Copy link
Contributor Author

Copilot AI commented Aug 29, 2025

@copilot Please address the remaining comments.

Addressed all remaining comments: fixed relative link, converted snippets to ::: format, copied and referenced all diagrams from the C# version, and ensured the project builds successfully. Commit: 41f0f0b

Copilot finished work on behalf of BillWagner August 29, 2025 18:11
@Copilot Copilot AI requested a review from BillWagner August 29, 2025 18:11
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Once I upgrade to .NET 9, this is ready.

@BillWagner BillWagner marked this pull request as ready for review August 29, 2025 18:29
@BillWagner BillWagner requested a review from a team as a code owner August 29, 2025 18:29
@BillWagner BillWagner requested a review from adegeo August 29, 2025 18:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dotnet-visualbasic/svc okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Async image on vb page shows csharp istead of vb Code diagram shows C# but this is a VB.NET specific page
2 participants