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
* 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
Adrian Hall