Azure / azure-sdk-for-net

This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
MIT License
5.17k stars 4.53k forks source link

Add a README to Azure.Template #12818

Closed annelo-msft closed 6 months ago

annelo-msft commented 4 years ago

The existing README is a README template -- we should add one in the sdk\template directory to describe what's in Azure.Template and how to extend it to build out a service library.

jsquire commented 1 year ago

Closing; Azure Template has a read me.

jsquire commented 1 year ago

Reopening; I misunderstood the proposed content. This does not exist currently.

pallavit commented 1 year ago

Given we expect all SDKs to be starting with DPG onboarding guide, do we see value in adding the following content /cc: @jsquire , @annelo-msft

annelo-msft commented 1 year ago

See https://github.com/Azure/azure-sdk-for-net/issues/12903#issuecomment-1599012716

I still feel it would be good to at least link to other docs from the template directory, but I'm also happy to defer to whomever feels most strongly about this.

pallavit commented 1 year ago

Given some of the onboarding is aspirational at this point, let's keep this tracking for now. As we see more of it come to light we can make the call at the time.

jsquire commented 1 year ago

I don't have a strong opinion on this one.

pallavit commented 6 months ago

Given where we are with onboarding experience I believe this issue can be closed. I have not seen any new SDKs being created via the template as we did earlier in quite some time.

/cc: @jsquire , @annelo-msft - if you feel strongly about it please feel free to reopen.

annelo-msft commented 6 months ago

I'm fine with closing this if we have a good holistic solution to onboarding and a different approach works better for the e2e

jsquire commented 6 months ago

I can't say whether or not the template is still being used as a reference point, but the structure is definitely still being used for new libraries. I have no issue closing this out, however.