Skip to content

Replace bacon references with hash browns for inclusivity in async programming docs #47135

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

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jul 8, 2025

Summary

This PR addresses issue #25475 by replacing all references to "bacon" with "hash browns" throughout the C# asynchronous programming documentation to make it more inclusive for developers with dietary restrictions based on religious beliefs, veganism, or vegetarianism.

Changes Made

Documentation Updates

  • Main file: docs/csharp/asynchronous-programming/index.md
    • Updated breakfast preparation instructions from "Fry three slices of bacon" to "Cook three hash brown patties"
    • Replaced all narrative text references to bacon with hash browns
    • Updated code examples and variable names (BaconHashBrown, FryBaconFryHashBrowns)
    • Updated console output messages and image alt-text descriptions

Code Example Updates

Updated all four breakfast async programming examples in docs/csharp/asynchronous-programming/snippets/index/:

  • AsyncBreakfast-starter: Updated synchronous version with hash brown class and methods
  • AsyncBreakfast-V2: Updated basic async version with FryHashBrownsAsync method
  • AsyncBreakfast-V3: Updated task composition version with hash brown task handling
  • AsyncBreakfast-final: Updated Task.WhenAny version with hash brown task monitoring

Why Hash Browns Work Well

Hash browns are an excellent replacement because they:

  • Are plant-based and inclusive of most dietary restrictions
  • Can be "flipped" during cooking (maintaining code example accuracy)
  • Take similar cooking time as bacon (preserving async timing examples)
  • Are a common breakfast item that fits the cooking analogy perfectly

Verification

✅ All code examples build successfully
✅ All examples run correctly with updated output
✅ Documentation flows naturally with new terminology
✅ No bacon references remain in the codebase

Example output from the final async version:

Pouring coffee
coffee is ready
Warming the egg pan...
putting 3 hash brown patties in the pan
cooking first side of hash browns...
...
hash browns are ready
Breakfast is ready!

This change makes the documentation more welcoming to all developers while maintaining the effectiveness of the async programming teaching examples.

Fixes #25475


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

@BillWagner
Copy link
Member

@copilot Please start working on this again.

@BillWagner BillWagner closed this Jul 9, 2025
@BillWagner BillWagner reopened this Jul 9, 2025
@dotnet-policy-service dotnet-policy-service bot added the okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings. label Jul 9, 2025
@BillWagner
Copy link
Member

@copilot can you start working on this again?

@BillWagner
Copy link
Member

@copilot Can you start working on this again?

Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] Consider not using bacon in your example Replace bacon references with hash browns for inclusivity in async programming docs Jul 10, 2025
Copilot finished work on behalf of BillWagner July 10, 2025 20:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
async-task-programming/subsvc dotnet-csharp/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.

Consider not using bacon in your example
2 participants