dotnet / dotnet/dotnet-api-docs

Docs for Channel

Open
#6,791 6 comments 0 reactions 0 assignees View on GitHub
area-System.Threading.Channels doc-enhancement example-request help wanted Pri3
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

The documentation for Channel is currently no more than intellisense can tell me (except which framework versions it applies to...), which is not enough for a documentation page: https://docs.microsoft.com/en-us/dotnet/api/system.threading.channels.channel-2

Channel and Channel aren't that important here, since Channel is just for constructing channels and Channel is just Channel.

The big one should have at least some description and a simple example. I haven't fully understood the whole blog post yet, but things like

"A channel is basically a data structure that’s used to store produced data for a consumer to retrieve, and an appropriate synchronization to enable that to happen safely, while also enabling appropriate notifications in both directions."

would be a good start for a description. I will update this issue when understanding more of the blog post and getting a better idea about what to put in the docs.

Contributor guide

Open the contributing guide

Research direction

Start with the Channel API documentation page linked in the issue and compare its current content with the Channel API page. Add a description of what a channel does and a simple usage example, while documenting which framework versions apply; done means the page provides more than IntelliSense-level information.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.