-
Notifications
You must be signed in to change notification settings - Fork 10.4k
Open
Labels
DocsThis issue tracks updating documentationThis issue tracks updating documentationaffected-mediumThis issue impacts approximately half of our customersThis issue impacts approximately half of our customersarea-infrastructureIncludes: MSBuild projects/targets, build scripts, CI, Installers and shared frameworkIncludes: MSBuild projects/targets, build scripts, CI, Installers and shared frameworkenhancementThis issue represents an ask for new feature or an enhancement to an existing oneThis issue represents an ask for new feature or an enhancement to an existing oneseverity-majorThis label is used by an internal toolThis label is used by an internal tool
Milestone
Description
Part of #27380.
Let's improve the project-specific docs in the repo. For larger projects (Blazor, MVC, SignalR) the docs should contain information about the project's dependency, test setup, an overview of the folder structure, etc. For smaller projects, the doc should contain a description of the contents and what they might be useful for.
- Anaylzers (@JunTaoLuo)
- Antiforgery (@pranavkm)
- Azure (@Tratcher)
- Components (@captainsafia)
- DataProtection (@HaoK)
- DefaultBuilder (@halter73)
- FileProviders (@wtgodbe)
- Framework (@HaoK)
- Grpc (@JamesNK)
- HealthChecks (@halter73)
- Hosting (@BrennanConroy)
- Html/Abstractions (@captainsafia)
- Http (@jkotalik)
- Identity (@JunTaoLuo)
- Installers (@wtgodbe)
- JSInterop (@SteveSandersonMS)
- Localization (@pranavkm)
- Middleware (@captainsafia)
- ObjectPool (@JunTaoLuo)
- ProjectTemplates (@HaoK)
- Razor (@javiercn)
- Security (@Tratcher)
- Servers/(HttpSys|IIS|test/FunctionalTests) (@jkotalik)
- Servers/Kestrel (@jkotalik)
- Shared (@captainsafia)
- SignalR (@BrennanConroy)
- SiteExtensions (@jkotalik)
- Testing (@captainsafia)
- Tools (@pranavkm)
- WebEncoders (@wtgodbe)
Below is a sample README to use when populating each project so the repo is consistent.
# ProjectName
A brief description of the project area here. In applicable, include a link to the `docs.microsoft.com` page associated with this area.
## Description
An overview of the source files within the project, a general overview of the design, and other information helpful to get the general idea of the implementation. For full-fledged areas like SignalR or Blazor, this should be a paragraph or a few sentences with some bullets.
## Development Setup
### Build
Provide a description of any dependencies that are needed to run the project, helpful flags that users can use when invoking the `build.cmd` command, and any other project-specific build instructions that would aid users during dev.
If applicable, include this standard statement at the end to point users to the top-level instructions for building each project from source.
To build this specific project from source, follow the instructions [on building the project](../../docs/BuildFromSource.md#step-3-build-the-repo).
### Test
A guide on how to run the tests for the project, including any dependencies that are needed to run the tests,
Include any information about specific customizations made to the tests for this project area (e.g. TestServer in Components project).
If applicable, include this standard statement at the end to point users to top-level instructions.
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).
Metadata
Metadata
Assignees
Labels
DocsThis issue tracks updating documentationThis issue tracks updating documentationaffected-mediumThis issue impacts approximately half of our customersThis issue impacts approximately half of our customersarea-infrastructureIncludes: MSBuild projects/targets, build scripts, CI, Installers and shared frameworkIncludes: MSBuild projects/targets, build scripts, CI, Installers and shared frameworkenhancementThis issue represents an ask for new feature or an enhancement to an existing oneThis issue represents an ask for new feature or an enhancement to an existing oneseverity-majorThis label is used by an internal toolThis label is used by an internal tool