Improve the C# language reference documentation with clearer examples #55955

Activity

1. dotnetrepoman

   added

   dotnet-csharp/svc

   lang-reference/subsvc

   on Sep 11, 2026
2. dotnet-policy-service

   added

   ⌚ Not TriagedNot triagedNot triaged

   on Sep 11, 2026
3. chukwuwww411-commits commented on Sep 11, 2026

   

   chukwuwww411-commits

   on Sep 11, 2026

   Author

   More actions

   I would like to contribute to this issue. I have reviewed the request and would be happy to work on the proposed C# language improvement.

   I can prepare the change, add appropriate tests, and update the documentation if needed. Please let me know if there are any specific implementation details or contribution guidelines I should follow before I begin.
4. chukwuwww411-commits commented on Sep 11, 2026

   

   chukwuwww411-commits

   on Sep 11, 2026

   Author

   More actions

   Thank you for the issue

   I’m interested in contributing to this issue. I’ll review the existing C# language-service implementation and follow the repository’s contribution guidelines.

   Proposed approach

   • Review the current implementation and related tests.
   • Identify the appropriate change needed for this issue.
   • Add or update tests where necessary.
   • Keep the changes focused and consistent with the project’s coding style.
   • Test the changes before submitting a pull request.

   Thank you for maintaining the project and for the opportunity to contribute.
5. chukwuwww411-commits commented on Sep 11, 2026

   

   chukwuwww411-commits

   on Sep 11, 2026

   Author

   More actions

   Thank you for the issue

   I’m interested in contributing to this issue. I’ll review the existing C# language-service implementation and follow the repository’s contribution guidelines.

   Proposed approach

   • Review the current implementation and related tests.
   • Identify the appropriate change needed for this issue.
   • Add or update tests where necessary.
   • Keep the changes focused and consistent with the project’s coding style.
   • Test the changes before submitting a pull request.

   Thank you for maintaining the project and for the opportunity to contribute.
6. chukwuwww411-commits commented on Sep 11, 2026

   

   chukwuwww411-commits

   on Sep 11, 2026

   Last edited by chukwuwww411-commits

   Author

   More actions

   from pathlib import Path

   content = """# Contribution Plan — GitHub Issue #55955

   Issue

   Improve the C# language service

   Purpose

   This document records a proposed contribution plan for issue #55955. It is intended to help organize the work before making any code changes.

   Proposed approach

   1. Review the issue discussion and existing implementation.
   2. Locate the relevant C# language-service code.
   3. Check existing tests and identify where coverage should be added or updated.
   4. Implement only the changes required by the issue.
   5. Run the relevant test suite and verify that existing behavior is not broken.
   6. Update documentation if the change requires it.
   7. Submit the changes as a focused pull request for review.

   Checklist

   • Reviewed issue Improve the C# language reference documentation with clearer examples #55955
   • Reviewed relevant existing code
   • Checked contribution guidelines
   • Added or updated tests where appropriate
   • Tested the changes locally
   • Reviewed the final diff
   • Ready for maintainer review

   Notes

   This is a planning document, not a claim that the implementation has already been completed.
   """
   path = Path("/mnt/data/github_issue_55955_contribution_plan.md")
   path.write_text(content, encoding="utf-8")
   print(path)
7. BillWagner commented on Sep 14, 2026

   

   BillWagner

   on Sep 14, 2026

   Member

   More actions

   Hi @chukwuwww411-commits

   I'd like to re-purpose your efforts here. The primary goal of the reference material is technical accuracy. The content should still have numerous small examples that demonstrate different features. However, it's meant to be useful for more experienced C# developers. The "Fundamentals" section is where these same topics are covered for developers new to C# (or new to development).

   In broad strokes, the journey should be from the "Getting started" section, through "Fundamentals", and then to the reference or other deep dive sections.

   That said, I'm interested in improving the overall experience. First, if you see areas in the fundamentals section that have the same deficiencies, that's where to provide more beginner friendly content. Second, search results drop beginners into the reference section, we want to improve the search visibility for the corresponding fundamentals section, or drive readers to that section.

   Let me know what you think.
8. BillWagner

   added

   needs-more-infoNeeds more info from OP. Auto-closed after 2 weeks if no response. [org][resolution]Needs more info from OP. Auto-closed after 2 weeks if no response. [org][resolution]

   and removed

   ⌚ Not TriagedNot triagedNot triaged

   on Sep 14, 2026
9. chukwuwww411-commits commented on Sep 18, 2026

   

   chukwuwww411-commits

   on Sep 18, 2026

   Author

   More actions

   Perfect
10. dotnet-policy-service

    removed

    needs-more-infoNeeds more info from OP. Auto-closed after 2 weeks if no response. [org][resolution]Needs more info from OP. Auto-closed after 2 weeks if no response. [org][resolution]

    on Sep 18, 2026
11. chukwuwww411-commits commented on Sep 22, 2026

    

    chukwuwww411-commits

    on Sep 22, 2026

    Author

    More actions

    Perfect
12. chukwuwww411-commits commented on Sep 22, 2026

    

    chukwuwww411-commits

    on Sep 22, 2026

    Author

    More actions

    from pathlib import Path

    content = """# Contribution Plan — GitHub Issue #55955

    Issue

    Improve the C# language service

    Purpose

    This document records a proposed contribution plan for issue #55955. It is intended to help organize the work before making any code changes.

    Proposed approach

    1. Review the issue discussion and existing implementation.
    2. Locate the relevant C# language-service code.
    3. Check existing tests and identify where coverage should be added or updated.
    4. Implement only the changes required by the issue.
    5. Run the relevant test suite and verify that existing behavior is not broken.
    6. Update documentation if the change requires it.
    7. Submit the changes as a focused pull request for review.

    Checklist

    • Reviewed issue Improve the C# language reference documentation with clearer examples #55955
    • Reviewed relevant existing code
    • Checked contribution guidelines
    • Added or updated tests where appropriate
    • Tested the changes locally
    • Reviewed the final diff
    • Ready for maintainer review

    Notes

    This is a planning document, not a claim that the implementation has already been completed.
    """
    path = Path("/mnt/data/github_issue_55955_contribution_plan.md")
    path.write_text(content, encoding="utf-8")
    print(path)
13. chukwuwww411-commits commented on Sep 22, 2026

    

    chukwuwww411-commits

    on Sep 22, 2026

    Author

    More actions

    from pathlib import Path

    content = """# Contribution Plan — GitHub Issue #55955

    Issue

    Improve the C# language service

    Purpose

    This document records a proposed contribution plan for issue #55955. It is intended to help organize the work before making any code changes.

    Proposed approach

    1. Review the issue discussion and existing implementation.
    2. Locate the relevant C# language-service code.
    3. Check existing tests and identify where coverage should be added or updated.
    4. Implement only the changes required by the issue.
    5. Run the relevant test suite and verify that existing behavior is not broken.
    6. Update documentation if the change requires it.
    7. Submit the changes as a focused pull request for review.

    Checklist

    • Reviewed issue Improve the C# language reference documentation with clearer examples #55955
    • Reviewed relevant existing code
    • Checked contribution guidelines
    • Added or updated tests where appropriate
    • Tested the changes locally
    • Reviewed the final diff
    • Ready for maintainer review

    Notes

    This is a planning document, not a claim that the implementation has already been completed.
    """
    path = Path("/mnt/data/github_issue_55955_contribution_plan.md")
    path.write_text(content, encoding="utf-8")
    print(path)
14. chukwuwww411-commits commented on Sep 22, 2026

    

    chukwuwww411-commits

    on Sep 22, 2026

    Author

    More actions

    from pathlib import Path

    content = """# Contribution Plan — GitHub Issue #55955

    Issue

    Improve the C# language service

    Purpose

    This document records a proposed contribution plan for issue #55955. It is intended to help organize the work before making any code changes.

    Proposed approach

    1. Review the issue discussion and existing implementation.
    2. Locate the relevant C# language-service code.
    3. Check existing tests and identify where coverage should be added or updated.
    4. Implement only the changes required by the issue.
    5. Run the relevant test suite and verify that existing behavior is not broken.
    6. Update documentation if the change requires it.
    7. Submit the changes as a focused pull request for review.

    Checklist

    • Reviewed issue Improve the C# language reference documentation with clearer examples #55955
    • Reviewed relevant existing code
    • Checked contribution guidelines
    • Added or updated tests where appropriate
    • Tested the changes locally
    • Reviewed the final diff
    • Ready for maintainer review

    Notes

    This is a planning document, not a claim that the implementation has already been completed.
    """
    path = Path("/mnt/data/github_issue_55955_contribution_plan.md")
    path.write_text(content, encoding="utf-8")
    print(path)