Documentation on MS Docs needs updating (v8)
@asanyaga is already working on this.
Since Jul 29, 2021.
- Dominant language
- C#
- Stars
- 505
- Forks
- 186
- PR merge metrics
- No merged PRs in 30d
Description
Most of the documentation here: https://docs.microsoft.com/en-us/odata/webapi/getting-started
Target the OData ASP.NET, ASP.NET Core library v6 or v7. There is no documentation on v8 other than a few blogs outlining changes with respect to Endpoint Routing.
As a user who is looking to adopt OData for our ASP.NET Core Web APIs for the first time, it's rather confusing to see information scattered across blog posts and none of them fully documented on MS Docs. First I had to read the v6/v7 docs to understand fundamentals then read the v7->v8 changes to understand the incremental changes.
(If I'm a new user coming to OData for the first time, I really don't need to see v6/v7. It should be a 1-step onboard to v8)
In fact, the MS Docs documentation makes zero references to ASP.NET Core 3.1 even (still referencing v2), when 3.1 has already become LTS with .NET 5 being pushed officially, and .NET 6 just around the corner.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.