dotnet/dotnet-api-docs

View on GitHub

.NET API reference documentation (.NET 8+)

Stars: 950
Forks: 1.7k
Open beginner issues: 98
Indexed issues: 1.6k
Avg merge: 3d 5h
Merged PRs (30d): 38

Dominant language: C#
License: No license data
Last GitHub push: Sep 19, 2026
Latest indexed: Sep 15, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

1,576 open issues indexed

Company email Open

untriaged

Difficulty 5/5 Over a week Newbie friendliness 10/100

dotnet/dotnet-api-docs#13078 · Opened Sep 19, 2026
Follow-up: apply crypto security-warning comments to snippets skipped in #12524 due to build infra Open

area-System.Security untriaged

Difficulty 5/5 Over a week Newbie friendliness 35/100

dotnet/dotnet-api-docs#13071 · 1 comment · Opened Sep 16, 2026
UriComponents.Path documentation implies LocalPath is always returned, but this is only true for file:// URIs Open

untriaged

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/dotnet-api-docs#13039 · 1 comment · Opened Aug 27, 2026
DisplayAttribute string properties: Remarks incorrectly state the property performs resource lookup Open

area-System.ComponentModel.DataAnnotations untriaged

Difficulty 1/5 1-3 hours Newbie friendliness 88/100

dotnet/dotnet-api-docs#13023 · 1 comment · Opened Aug 23, 2026
No "Read" method found on UdpClient Open

area-System.Net.Sockets untriaged

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/dotnet-api-docs#13022 · 1 comment · Opened Aug 22, 2026
Is memory load bytes a count of bytes or a ratio Open

area-System.Runtime untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

dotnet/dotnet-api-docs#13015 · 1 comment · Opened Aug 20, 2026
Add PNSE exceptions per unsupported APIs catalog Open

untriaged

dotnet/dotnet-api-docs#13007 · 1 assignee · Opened Aug 19, 2026
Confusing terminology in SafeHandle example code Open

area-System.Runtime.InteropServices untriaged

Difficulty 1/5 Under an hour Newbie friendliness 84/100

dotnet/dotnet-api-docs#12959 · Opened Aug 8, 2026
Confusing "implement a Close method" Open

area-System.Runtime untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

dotnet/dotnet-api-docs#12957 · 1 comment · Opened Aug 8, 2026
Update API docs for .NET 11 breaking changes Open

:pushpin: seQUESTered area-Meta untriaged

dotnet/dotnet-api-docs#12933 · 1 assignee · Opened Aug 4, 2026
Misinformation on multi-threaded behavior Open

area-System.Runtime untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

dotnet/dotnet-api-docs#12900 · 1 comment · Opened Jul 23, 2026
WebSocket.CloseStatus: Actual value is null when socket is open, not non-existent WebSocketCloseStatus.None Open

area-System.Net untriaged

Difficulty 1/5 Under an hour Newbie friendliness 85/100

dotnet/dotnet-api-docs#12884 · 1 comment · Opened Jul 16, 2026
CollectionBuilderAttribute.MethodName remarks contradict CollectionBuilderAttribute(Type, String) Constructor remarks Open

area-System.Runtime.CompilerServices untriaged

Difficulty 1/5 Under an hour Newbie friendliness 85/100

dotnet/dotnet-api-docs#12883 · Opened Jul 14, 2026
Backport remarks/examples for System.Text.RegularExpressions Open

:pushpin: seQUESTered untriaged

dotnet/dotnet-api-docs#12869 · 1 reaction · 2 assignees · Opened Jul 7, 2026
More details needed on Uri.EscapeUriString Open

untriaged

Difficulty 4/5 3-5 days Newbie friendliness 20/100

dotnet/dotnet-api-docs#12814 · Opened Jun 26, 2026
Missing warning note on HttpUtility.UrlEncode()? Open

area-System.Net untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

dotnet/dotnet-api-docs#12813 · 3 comments · Opened Jun 26, 2026
`ArrayList` incorrect remarks Open

area-System.Collections untriaged

Difficulty 1/5 Under an hour Newbie friendliness 78/100

dotnet/dotnet-api-docs#12797 · 1 comment · Opened Jun 25, 2026
Document behaviour of ConcurrentDictionary AddOrUpdate when factory funcs throw Open

area-System.Collections untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

dotnet/dotnet-api-docs#12771 · 1 comment · Opened Jun 22, 2026
`SocketsHttpHandler` need more detailed docs Open

area-System.Net.Http untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

dotnet/dotnet-api-docs#12768 · 1 comment · Opened Jun 21, 2026
Misleading / incorrect documentaion on MulticastLoopback (UdpClient) Open

area-System.Net untriaged

Difficulty 3/5 1-2 days Newbie friendliness 68/100

dotnet/dotnet-api-docs#12764 · 1 comment · Opened Jun 19, 2026
Incomplete description for Task.Wait(TimeSpan, CancellationToken) Open

area-System.Threading.Tasks untriaged

Difficulty 1/5 Under an hour Newbie friendliness 90/100

dotnet/dotnet-api-docs#12759 · 1 comment · Opened Jun 18, 2026
The `DeflateStream.Flush()` implementation DOES have functionality on .net 10 Open

:pushpin: seQUESTered area-System.IO.Compression untriaged

dotnet/dotnet-api-docs#12755 · 1 comment · 2 reactions · 2 assignees · Opened Jun 17, 2026
IPNetwork remark about lower bits is different for net10.0 Open

area-System.Net untriaged

Difficulty 1/5 1-3 hours Newbie friendliness 78/100

dotnet/dotnet-api-docs#12731 · 1 comment · Opened Jun 10, 2026
System.Text: Clarify best practices for application developers to read and write files with preamble/Byte Order Marks Open

area-System.Text.Encoding

Difficulty 4/5 3-5 days Newbie friendliness 56/100

dotnet/dotnet-api-docs#12728 · 1 comment · Opened Jun 9, 2026
ChannelFactory does not have string parameter overload in modern .NET Open

area-WCF needs-area-label untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

dotnet/dotnet-api-docs#12725 · Opened Jun 8, 2026
System.Printing.PrintQueueStatus enum value "NotAvailable" doc is misleading/incorrect Open

area-WinForms needs-area-label untriaged

Difficulty 1/5 Under an hour Newbie friendliness 68/100

dotnet/dotnet-api-docs#12723 · 2 comments · 1 reaction · Opened Jun 8, 2026
Race condition in the example Open

area-System.Threading needs-area-label untriaged

Difficulty 1/5 Under an hour Newbie friendliness 86/100

dotnet/dotnet-api-docs#12721 · Opened Jun 7, 2026
WebSocketReceiveResult.MessageType: Document that type can also be "close" Open

area-System.Net.Sockets untriaged

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/dotnet-api-docs#12717 · 1 comment · Opened Jun 5, 2026
JsonSerializer: Document on class page whether it is thread-safe Open

area-System.Text.Json untriaged

dotnet/dotnet-api-docs#12714 · 1 comment · 1 reaction · 2 assignees · Opened Jun 4, 2026
Modernize all C# code snippets Open

:pushpin: seQUESTered area-Meta untriaged

dotnet/dotnet-api-docs#12713 · 1 assignee · Opened Jun 4, 2026
Document which HttpClient methods are thread-safe, on class page and individual method pages Open

area-System.Net untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

dotnet/dotnet-api-docs#12711 · 1 comment · Opened Jun 4, 2026
ValueTask<TResult> documentation is outdated for .NET 10 - repeated await no longer throws Open

area-System.Threading.Tasks untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

dotnet/dotnet-api-docs#12704 · 3 comments · Opened Jun 3, 2026
ValidationException(ValidationResult, ValidationAttribute, Object): Incorrect parameter description for "validationResult" Open

area-System.ComponentModel.DataAnnotations untriaged

Difficulty 1/5 Under an hour Newbie friendliness 85/100

dotnet/dotnet-api-docs#12693 · 1 comment · Opened Jun 1, 2026
Several errors in ValidationException(String, Exception) constructor Open

area-System.ComponentModel.DataAnnotations untriaged

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/dotnet-api-docs#12692 · 1 comment · Opened Jun 1, 2026
Include information about known issues in `Expression.Block` documentation. Open

area-System.Linq.Expressions untriaged

Difficulty 2/5 Half a day Newbie friendliness 65/100

dotnet/dotnet-api-docs#12691 · 1 comment · Opened Jun 1, 2026
Broken Link Open

area-System.Collections untriaged

Difficulty 1/5 Under an hour Newbie friendliness 72/100

dotnet/dotnet-api-docs#12673 · 1 comment · Opened May 28, 2026
Missing named option instance Open

area-Extensions-Options untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

dotnet/dotnet-api-docs#12672 · 2 comments · Opened May 28, 2026
Threre are issues in the class PerformanceCounter Open

area-System.Diagnostics.PerformanceCounter needs-area-label untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

dotnet/dotnet-api-docs#12667 · Opened May 28, 2026
WebSocket: Document how WebSocket enters Aborted, what states are allowed pre-conditions for calling CloseAsync and CloseOutputAsync, and which exception is thrown if state pre-condition is violated Open

area-System.Net.Sockets untriaged

Difficulty 3/5 1-2 days Newbie friendliness 68/100

dotnet/dotnet-api-docs#12642 · 2 comments · Opened May 21, 2026
WebSocket thread-safety: Copy relevant ManagedWebSocket code comments into Microsoft Learn WebSocket docs (if true for WebSocket class broadly) Open

area-System.Net.Sockets untriaged

Difficulty 4/5 3-5 days Newbie friendliness 45/100

dotnet/dotnet-api-docs#12640 · 2 comments · Opened May 21, 2026
Misleading remarks about degree of parallelism Open

area-System.Threading.Tasks untriaged

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

dotnet/dotnet-api-docs#12637 · 3 comments · Opened May 21, 2026
OrdereredDictionary<K,V> and the KeyNotFoundException Open

area-System.Collections untriaged

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/dotnet-api-docs#12621 · 1 comment · Opened May 13, 2026
The published .xrefmap.json is broken Open

area-Infrastructure untriaged

dotnet/dotnet-api-docs#12615 · 9 comments · 4 reactions · 1 assignee · Opened May 12, 2026
API Browser redirecting to .net Framework 4.8.1 or earlier for a lot of APIs Open

area-Infrastructure untriaged

Difficulty 4/5 3-5 days Newbie friendliness 48/100

dotnet/dotnet-api-docs#12614 · 16 comments · 34 reactions · Opened May 12, 2026
API Open

Difficulty 5/5 Over a week Newbie friendliness 10/100

dotnet/dotnet-api-docs#12610 · Opened May 9, 2026
Host.CreateDefaultBuilder should specify that on windows it adds the EventLog Provider Open

area-Extensions-Hosting untriaged

Difficulty 1/5 1-3 hours Newbie friendliness 72/100

dotnet/dotnet-api-docs#12600 · 1 comment · Opened May 6, 2026
Documents Open

Difficulty 5/5 Over a week Newbie friendliness 1/100

dotnet/dotnet-api-docs#12595 · 1 reaction · Opened May 4, 2026
Publish .NET 11 GA APIs Open

area-Meta untriaged

dotnet/dotnet-api-docs#12594 · 1 assignee · Opened May 1, 2026
Publish .NET 11 RC 2 APIs Open

area-Meta untriaged

dotnet/dotnet-api-docs#12593 · 1 assignee · Opened May 1, 2026
dotnet-api/sha256rsa@me Open

Difficulty 4/5 3-5 days Newbie friendliness 20/100

dotnet/dotnet-api-docs#12570 · 1 reaction · Opened Apr 28, 2026

dotnet/dotnet-api-docs

Get new issues in your inbox