Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

changelog for storage common and blob #974

Merged
merged 12 commits into from
Nov 13, 2020
Merged

Conversation

Jinming-Hu
Copy link
Member

No description provided.

@Jinming-Hu Jinming-Hu added Client This issue points to a problem in the data-plane of the library. Storage Storage Service (Queues, Blobs, Files) labels Nov 13, 2020
@Jinming-Hu Jinming-Hu added this to the [2020] November milestone Nov 13, 2020
@Jinming-Hu Jinming-Hu self-assigned this Nov 13, 2020
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Outdated Show resolved Hide resolved
sdk/storage/azure-storage-blobs/CHANGELOG.md Show resolved Hide resolved
Co-authored-by: Ahson Khan <ahkha@microsoft.com>
@ahsonkhan
Copy link
Contributor

Look through these:
ef4b7c5...97af13d

Jinming-Hu and others added 3 commits November 13, 2020 11:17
Co-authored-by: Ahson Khan <ahkha@microsoft.com>
Co-authored-by: Ahson Khan <ahkha@microsoft.com>
Co-authored-by: Ahson Khan <ahkha@microsoft.com>
@ahsonkhan
Copy link
Contributor

Changed path of blobs.hpp and others:
blobs/inc/azure/storage/blobs/blob.hpp → ...storage-blobs/inc/azure/storage/blobs.hpp
#837

@ahsonkhan
Copy link
Contributor

Made SharedKeyCredential a class: #942

@ahsonkhan
Copy link
Contributor

Renamed/removed storage_version.hpp and added version.hpp
#845

@Jinming-Hu
Copy link
Member Author

Jinming-Hu commented Nov 13, 2020

Made SharedKeyCredential a class: #942

Is that even worth mentioning in changelog? Because it sounds to me pretty much just an implementation detail. How is our customers' code gonna be affected?

@ahsonkhan
Copy link
Contributor

ahsonkhan commented Nov 13, 2020

Is that even worth mentioning in changelog? Because it sounds to me pretty much just an implementation detail. How is our customers' code gonna be affected?

I agree its a subtle change but can be considered breaking (though unlikely, someone could have forward declared it with the same name). We called out the exception struct -> class change in Other changes and Improvements for that reason:
https://github.com/Azure/azure-sdk-for-cpp/releases/tag/azure-core_1.0.0-beta.3

Update SDK-defined exception types to be classes instead of structs.

@@ -1,10 +1,23 @@
# Release History

## 1.0.0-beta.5 (Unreleased)
## 12.0.0-beta.5 (2020-11-13)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@weshaggard would our build and release pipeline be able to handle this version jump from 1.0.0-beta.4 to 12.0.0-beta.5?


### New Features

* Support for replaceable HTTP transport layer.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this the new TransportPolicyOptions member as part of client options?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yep

### New Features

* Support for replaceable HTTP transport layer.
* Add `version.hpp`.

### Breaking Changes
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am surprised, but did we really have no bug fixes reported or made during this release? I don't see any myself, but maybe I missed it, so just want to confirm.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, i'm not really good at writing bugs.

Copy link
Member

@katmsft katmsft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor comments.

@ahsonkhan
Copy link
Contributor

what
the

These are some fun commit messages :p

### New Features

* Support for replaceable HTTP transport layer.
* Add `version.hpp`.
Copy link
Contributor

@ahsonkhan ahsonkhan Nov 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

super nit: If you would like to fix this going forward and for this current changelog, let's use past-tense similar to #978
https://github.com/Azure/azure-sdk-for-c/releases/tag/1.0.0
https://github.com/Azure/azure-sdk-for-cpp/releases/tag/azure-core_1.0.0-beta.3

The writing style will continue to differ (and we don't really enforce this), so not a big deal either way, but we can try to make an effort on consistent styling. Up to you.

For example:

Suggested change
* Add `version.hpp`.
* Added `version.hpp`.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, we did have this conversation within our team. It seems that it is just a personal style. If you take a look at TensorFlow you would find even within one file there are both styles. Search for Add will give you both past tense and simple present tense of the changelog.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I understand. Either is fine. Just wanted to mention it, in case we want to try to converge to one style. Leaving it as is, is fine as well :)

@Jinming-Hu Jinming-Hu merged commit c32f9b0 into Azure:master Nov 13, 2020
@Jinming-Hu Jinming-Hu deleted the pr1 branch November 13, 2020 05:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Client This issue points to a problem in the data-plane of the library. Storage Storage Service (Queues, Blobs, Files)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants