Skip to content

Add definitions for expressions and statements to C# fundamentals program structure #46896

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

Merged
merged 4 commits into from
Jun 19, 2025

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jun 19, 2025

This PR addresses the gap in fundamental C# documentation by adding clear, working definitions for "expressions" and "statements" to the program structure guide. These concepts are essential for understanding C# programming, especially as the language evolves to include more expression-based features.

Changes Made

Added a new "Expressions and statements" section to /docs/csharp/fundamentals/program-structure/index.md that includes:

  • Clear definitions: Expressions evaluate to values; statements perform actions
  • Concrete examples: 5 examples each to illustrate the concepts
  • Key distinction explanation: How to tell expressions from statements
  • Edge case coverage: Method calls can be both expressions and statements
  • Cross-references: Links to existing detailed documentation

Example Content

Expression examples:

  • 42 (literal value)
  • x + y (arithmetic operation)
  • Math.Max(a, b) (method call)
  • condition ? trueValue : falseValue (conditional expression)

Statement examples:

  • int x = 42; (declaration statement)
  • Console.WriteLine("Hello"); (expression statement)
  • if (condition) { /* code */ } (selection statement)

The definitions are placed logically after the program structure explanation but before the Related Sections, making them easily discoverable for beginners learning C# fundamentals.

Fixes #42561.


💬 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/csharp/fundamentals/program-structure/index.md docs/csharp/fundamentals/program-structure/index

@Copilot Copilot AI changed the title [WIP] This section needs working definitions for "expression" and "statement" Add definitions for expressions and statements to C# fundamentals program structure Jun 19, 2025
@Copilot Copilot AI requested a review from BillWagner June 19, 2025 16:28
Copilot finished work on behalf of BillWagner June 19, 2025 16:28
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 a great start. I have a couple suggestions to improve the flow of the text.

@Copilot Copilot AI requested a review from BillWagner June 19, 2025 16:46
Copilot finished work on behalf of BillWagner June 19, 2025 16:46
@BillWagner BillWagner marked this pull request as ready for review June 19, 2025 17:07
@BillWagner BillWagner requested a review from a team as a code owner June 19, 2025 17:07
@BillWagner BillWagner requested a review from gewarren June 19, 2025 17:08
@BillWagner BillWagner enabled auto-merge (squash) June 19, 2025 17:08
auto-merge was automatically disabled June 19, 2025 17:27

Head branch was pushed to by a user without write access

Copilot finished work on behalf of gewarren June 19, 2025 17:28
@Copilot Copilot AI requested a review from gewarren June 19, 2025 17:28
@BillWagner BillWagner merged commit ee28614 into main Jun 19, 2025
10 checks passed
@BillWagner BillWagner deleted the copilot/fix-42561 branch June 19, 2025 18:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

This section needs working definitions for "expression" and "statement"
3 participants