Updates reflect the current state of the world for naming of options and
response envelope types.
Promote client constructors that use AAD token auth or the service
preferred authentication mechanism.
Paged and long-running operations now return their respective generic
types.
Resuming an LRO now uses the resume token in the Begin* method.
* Refactor Go design guidelines
This moves the content to follow the template used across all languages.
Topics that have not yet been covered by the guidelines were left with a
TODO comment with rare exception.
No existing content was changed in any way.
* removed optional prefix
* Consistent Sidebar & updating Styles
- Updating the site to have a consistent sidebar accross all of it's pages
- Cleaning up and reorganizing the .Net Side bar menu
- Reorganizing the Java side bar menu.
NO CONTENT changes have been done in this PR.
* Reverting Changes in index
Reverting Changes in index
* Updating broken API documentaiton links in the new Sidebar
The new Side Bar that I introduced contained wrong links so I updated them here
Co-authored-by: sameralameer <samer.m.alameer@gmail.com>
* Updates to Go design guidelines
Added new dependency.
Updated section on optional method parameters.
Fixed up comments for pollers.
Some other minor tweaks.
* fix example
To summarize the changes:
For preview releases we will use “-beta” as the prerelease tag for all languages. Instead of “-preview”.
For daily dev builds we will use “-alpha” as the prerelease tag for all languages. Instead of “-dev”.
The move from “preview” to “beta” is to make the languages consistent and is to avoid confusion with using “preview” as it has meaning for Azure services that indicates people get discounted rates. The move from “dev” to “alpha” is to have the versions that sort older then “beta” and helps ensure that our daily dev versions, which are less stable, don’t end up as the “latest” version for our customers when they are testing out our previews. Folks will have to take an extra opt-in step if they wish to test our daily dev versions, it won’t happen by accident like it can today.
I've also added a note in each language section on how folks can remain on the daily dev/alpha version train if they want to opt-in to those versions.
* Updating LRO documentation to reflect new design
* Adding *WidgetResponse to Begin definition example
* Improving resume example, cap HTTP, removing reporter references
* Improving WidgetResponse comment
* Removing all references to ID and adding err to resume token example
* Correct poller var names in LRO examples
Co-authored-by: Catalina Peralta <caperal@microsoft.com>
* moved and renamed various go doc sections
* fixes based on feedback
* move LRO info around
* fixed up paged types, other clean-up
* update LRO section
* merge implementation into design
* added missing directory structure info
refactored response types
* remove links to golang_implementation
* updates to response types
* Update design guidelines for Go
Added sections for logging, distributed tracing and versioning.
* feedback from review, add section about prerelease modules
Joel Hendrix
Gyeonghun Park
Ryuji Iwata
Samer Alameer
Wes Haggard
Jeffrey Richter
catalinaperalta
Adrian Hall