dotnet / dotnet/docs

Improve the C# language reference documentation with clearer examples

Open
#55,955 5 comments 0 reactions 0 assignees View on GitHub
:watch: Not Triaged dotnet-csharp/svc lang-reference/subsvc needs-more-info
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
19h 10m
Merged PRs (30d)
268

Description

### Type of issue

Other (describe below)

### Description

### What is the issue?

The C# language reference documentation would be easier to understand if some topics included more clear, practical, step-by-step examples.

### What I suggest

Please add more beginner-friendly examples and short code snippets that show how each concept works in a real situation.

This would make the documentation easier to follow, especially for developers who are learning C# and .NET.

### Why this would help

Clear examples can help readers understand the concepts faster, avoid confusion, and start writing C# code with more confidence.

Thank you for improving the C# documentation.

### Page URL

https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/value-types

### Content source URL

https://github.com/dotnet/docs/blob/main/docs/csharp/language-reference/builtin-types/value-types.md

### Document Version Independent Id

e2c7e9c5-ebd3-ed68-d2cc-6d8929c654e8

### Platform Id

3aa53bbc-9e47-812a-d8ea-36af4ae2f63a

### Article author

@BillWagner

### Metadata

* ID: 0948cf18-9971-b2d4-4f59-e045838e6e5f
* PlatformId: 3aa53bbc-9e47-812a-d8ea-36af4ae2f63a
* Service: **dotnet-csharp**
* Sub-service: **lang-reference**

[Related Issues](https://github.com/dotnet/docs/issues?q=is%3Aissue+is%3Aopen+e2c7e9c5-ebd3-ed68-d2cc-6d8929c654e8)

Contributor guide

Open the contributing guide

Research direction

Start by reading docs/csharp/language-reference/builtin-types/value-types.md and compare it with the published value-types page. Identify concepts that lack practical, step-by-step examples, then add focused C# snippets and explanations; the article should be easier for beginners to follow without changing its scope.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.