dotnet / dotnet/AspNetCore.Docs
Improving the YARP documentation organization
- Dominant language
- C#
- Stars
- 13.1k
- Forks
- 24.6k
- Avg merge
- 1d 3h
- Merged PRs (30d)
- 97
Description
As part of the migration to ASP.NET docs, it has been a forcing function to make me look at the docs. The following are some organization changes to improve the docs based on the new TOC. This asks to split up some of the topics under Configuration as they included both config & extensibility content - splitting those docs into 2 will make them shorter and more relevant based on how the customer is using YARP.
- [ ] /core/fundamentals/servers/yarp/transforms - split this doc at the `Extensibility` heading, and put the second half as `Transforms` under the extensibility node
- [ ] core/fundamentals/servers/yarp/load-balancing - split this doc at the `Extensibility` heading, and put the second half as `Load Balancing` under the extensibility node
- [ ] core/fundamentals/servers/yarp/dests-health-checks - split out the 2 Extensibility sections into one doc under the extensibility node in the TOC.
Another suggestion may to further split up the /core/fundamentals/servers/yarp/transforms doc into 3:
- Transforms overview
- Request Transforms
- Response Transforms and Response Trailers
And make it another layer in the TOC under `Proxy Features` as its quite a mammoth doc, and the split may make it easier from a TOC perspective to understand what you can do with transforms.
### Page URL
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/yarp/getting-started?view=aspnetcore-9.0
### Content source URL
https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/servers/yarp/getting-started.md
### Document ID
75f2623e-0c7d-3392-9b37-7a2d86163591
### Article author
@samsp-msft
### Metadata
* ID: 75f2623e-0c7d-3392-9b37-7a2d86163591
* Service: **aspnet-core**
* Sub-service: **fundamentals**
Contributor guide
Assessment
This issue has not been assessed yet.