tg-msft
tg-msft
Our guidelines should suggest `x-ms-client-request-id` for correlation with customer support.
We should provide a suggested starting point for common error code values in the [Considerations for Service Design doc](https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md). I've often pointed other services at Storage for an example ([Common](https://docs.microsoft.com/en-us/rest/api/storageservices/common-rest-api-error-codes),...
This came up during [the first draft of collections guidance](https://github.com/microsoft/api-guidelines/pull/243#discussion_r654526793). We should think about prescriptive guidance for projections (in List and maybe Get operations). Current Azure examples include: - `$select`...
This came up during [the first draft of collections guidance](https://github.com/microsoft/api-guidelines/pull/243#discussion_r654526793). We should think about prescriptive guidance for a default filtering language, how it relates to OData, and whether we want...
I struggled to find the latest Blobs docs for Go when getting started with the bug bash. The README shows `NewServiceClientWithSharedKey` but everything I find when searching things like "go...
I struggled to find the docs for the latest version of azblob per https://github.com/Azure/azure-sdk-for-go/issues/16498 but I would have felt confident I landed in the right spot if there was something...
General feedback about https://github.com/Azure/azure-sdk-for-go/blob/main/sdk/storage/azblob/README.md ### Create the client 1. In [Create the client](https://github.com/Azure/azure-sdk-for-go/blob/main/sdk/storage/azblob/README.md#create-the-client) you list the types of resources, but it'd be helpful to include the type of client like...
Detailed feedback about https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob@main ### [Constants](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob@main#pkg-constants) 1. Why are these grouped into so many different chunks? Why are BlockBlobMaxUploadBlobBytes, BlockBlobMaxStageBlockBytes, and BlockBlobMaxBlocks together but BlobDefaultDownloadBlockSize is off on its own?...
High level feedback about https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob@main 1. I don't really know what to make of this page as it includes a verbatim README followed by the real documentation. Is this standard...
The upcoming `Azure.RequestOptions` gives us the chance to expose [`ErrorOptions`](https://docs.microsoft.com/en-us/dotnet/api/azure.erroroptions?view=azure-dotnet) from our convenience methods. We're not planning to do this everywhere, but there have been a handful of cases where...