dotnet / dotnet/dotnet-api-docs

Create a HTTP in .NET tutorial

Open
#7,715 2 comments 1 reaction 0 assignees View on GitHub
area-System.Net.Http Pri3 untriaged
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

Searching for "HTTP in .NET" brings up one thing written by us, which is mostly about ASP.NET and HttpClientFactory cruft:

https://docs.microsoft.com/en-us/dotnet/core/extensions/http-client

We should refocus this on HttpClient scenarios. Suggestions:

- REST with various content types.
- Authentication.
- Form posting.
- Maybe some other "advanced" REST/header scenarios too, as more and more APIs are using these.
- the "HttpClient is an IDisposable connection pool" talk and various ways to instantiate/manage a client. (including, as a subsection, the bulk of the current docs.)
- SNAT
- Counters
- Diagnostics/troubleshooting.

We should also make the JSON extensions a more integrated part of the HttpClient docs. It isn't super obvious that these extensions exist and I've got feedback from people trying to figure out some 3rd party libraries that they went to those libraries because they didn't know the JSON extensions existed and were intimidated by integrating S.T.Json with HttpClient.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.