Readmes for HTTP and Site Extensions (#31250)

* Readmes for HTTP and Site Extensions

* Apply suggestions from code review

Co-authored-by: Brennan <[email protected]>

Co-authored-by: Brennan <[email protected]>

Author: jkotalik

src/Http/README.md

@@ -1,6 +1,37 @@
-Http Abstractions
-=================
+# Http
 
-This folders contains projects for HTTP abstractions for ASP.NET Core such as `HttpContext`, `HttpRequest`, `HttpResponse` and `RequestDelegate`.
+Http is a collection of HTTP abstractions used in ASP.NET Core, such as `HttpContext`, `HttpRequest`, `HttpResponse` and `RequestDelegate`.
 
-It also contains `IApplicationBuilder` and extensions to create and compose your application's pipeline.
+It also includes `Endpoint Routing` and `WebUtilities`.
+
+## Description
+
+The following contains a description of each sub-directory in the `Http` directory.
+
+- [Authentication.Abstractions/](Authentication.Abstractions/): Contains common types used by the various authentication components.
+- [Authentication.Core/](Authentication.Core/): Contains common types used by the various authentication middleware components.
+- [Headers/](Headers/): Contains headers and header parser implementations.
+- [Http/](Http/): Contains default HTTP feature implementations.
+- [Http.Abstractions/](Http.Abstractions/): Contains HTTP object model for HTTP requests and responses and also common extension methods for registering middleware in an IApplicationBuilder.
+- [Http.Extensions/](Http.Extensions/): Contains common extension methods for HTTP abstractions, HTTP headers, HTTP request/response, and session state.
+- [Http.Features/](Http.Features/): Contains HTTP feature interface definitions.
+- [Metadata/](Metadata/): Contains ASP.NET Core metadata.
+- [Owin/](Owin/): Contains components for running OWIN middleware in an ASP.NET Core application, and to run ASP.NET Core middleware in an OWIN application.
+- [Routing/](Routing/): Contains middleware for routing requests to application logic and for generating links.
+- [Routing.Abstractions/](Routing.Abstractions/): Contains abstractions for routing requests to application logic and for generating links.
+- [WebUtilities/](WebUtilities/): Contains utilities, for working with forms, multipart messages, and query strings.
+- [samples/](samples/): Contains samples.
+
+## Development Setup
+
+### Build
+
+To build this specific project from source, follow the instructions [on building a subset of the code](../../docs/BuildFromSource.md#building-a-subset-of-the-code).
+
+### Test
+
+To run the tests for this project, [run the tests on the command line](../../docs/BuildFromSource.md#running-tests-on-command-line) in this directory.
+
+## More Information
+
+For more information, see the [ASP.NET Core README](../../README.md).

src/SiteExtensions/README.md

@@ -0,0 +1,26 @@
+# SiteExtensions
+
+Site extensions are extensions specific to Azure App Services.
+
+## Description
+
+The following contains a description of each sub-directory in the `SiteExtensions` directory.
+
+- `LoggingAggregate`: Site extensions for logging integration for ASP.NET Core applications on Azure App Service.
+- `LoggingBranch`: Site extension which enables additional functionality for ASP.NET Core on Azure WebSites, such as enabling Azure logging.
+- `Runtime`: This site extension installs Microsoft.AspNetCore.App and Microsoft.NetCore.App shared runtimes.
+
+## Development Setup
+
+### Build
+
+To build this specific project from source, follow the instructions [on building a subset of the code](../../docs/BuildFromSource.md#building-a-subset-of-the-code).
+
+Or for the less detailed explanation, run the following command inside this directory.
+```powershell
+> ./build.cmd
+```
+
+## More Information
+
+For more information, see the [ASP.NET Core README](../../README.md).