dotnet / docs

This repository contains .NET Documentation.
https://learn.microsoft.com/dotnet
Creative Commons Attribution 4.0 International
4.18k stars 5.84k forks source link

Usage examples #27442

Open arogers-enthink opened 2 years ago

arogers-enthink commented 2 years ago

This page could benefit from some examples on using the created type based on the Enumeration class. Demonstrating why/how ID and name are related and used, etc.

Also recommend using the more completed Enumeration class from the microservices repo.


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

ahmad2smile commented 2 years ago

Not sure if it's related/is issue on each page, so many times I get a result from Search Engine to MS Docs for some API and looking for it's example on how to use it and there is nothing, I'm guessing here that I'm just bad at exploring MS Docs but...

Example this page regarding Binary Serialization link wouldn't it be helpful to have a getting started on the first page (Page you get from Search Engine) "Overview" rather than a long list of Serializable types which fills up the whole page and even on the end there is No Mention of examples.

I understand the examples are in the right menu under "How to:" for this particular case and this issue can just be very subjective thing, but I would argu my preference in this case mostly has been formed by every other Product's documentation norms.

erjain commented 1 year ago

Hi @ardalis, what are your thoughts?