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

docs: label legacy storage classes in documentation #267

Merged
merged 3 commits into from Apr 17, 2020

Conversation

dmitry-fa
Copy link
Contributor

Fixes #254

@googlebot googlebot added the cla: yes This human has signed the Contributor License Agreement. label Apr 17, 2020
@dmitry-fa dmitry-fa requested a review from frankyn April 17, 2020 08:48
Copy link
Member

@frankyn frankyn left a comment

Choose a reason for hiding this comment

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

Thanks for picking this up @dmitry-fa

*/
public static final StorageClass REGIONAL = type.createAndRegister("REGIONAL");

/**
* Multi-regional storage class. This is supported as a legacy storage class and will be
* deprecated in the future. See: https://cloud.google.com/storage/docs/storage-classes for
* details
* deprecated in the future. This class cannot be set. Unless you already are using it, you should
Copy link
Member

@frankyn frankyn Apr 17, 2020

Choose a reason for hiding this comment

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

Legacy storage classes can still be set, please remove This class cannot be set for all legacy storage classes.

Additionally, the issue that didn't across in my issue is that a developer at first only see's Mult-regional storage class. and not the rest.

ySdN1VJtAXu

The additional information isn't available until scrolling down:

FAuvGNOgqhx

If it's being truncated because of the period .. then I recommend this:

Legacy Multi-regional storage class, use STANDARD storage class for new buckets.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Legacy Multi-regional storage class, use REGIONAL storage class for new buckets.

  1. Do you really mean REGIONAL?

https://cloud.google.com/storage/docs/storage-classes#legacy recommends STANDARD class:

Unless you already are using one of these additional classes, you should use Standard Storage instead.

  1. A storage class can be set not only for buckets, but for object as well. And not only for new, but for existing. Right? May be it's not correct to say for new buckets

Copy link
Member

Choose a reason for hiding this comment

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

🤦‍♂️ I meant STANDARD.

Good catch (blobs vs buckets), then use:

Legacy {Storage class} storage class, use STANDARD storage class instead.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

legacyStorageClasses1

...

legacyStorageClasses2

Copy link
Member

@frankyn frankyn left a comment

Choose a reason for hiding this comment

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

Thanks @dmitry-fa, LGTM. Rerunning tests due to flake.

@frankyn frankyn added kokoro:force-run Add this label to force Kokoro to re-run the tests. automerge Merge the pull request once unit tests and other checks pass. labels Apr 17, 2020
@yoshi-kokoro yoshi-kokoro removed the kokoro:force-run Add this label to force Kokoro to re-run the tests. label Apr 17, 2020
@codecov
Copy link

codecov bot commented Apr 17, 2020

Codecov Report

Merging #267 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff            @@
##             master     #267   +/-   ##
=========================================
  Coverage     63.52%   63.52%           
  Complexity      540      540           
=========================================
  Files            30       30           
  Lines          4776     4776           
  Branches        431      431           
=========================================
  Hits           3034     3034           
  Misses         1580     1580           
  Partials        162      162           
Impacted Files Coverage Δ Complexity Δ
...in/java/com/google/cloud/storage/StorageClass.java 88.23% <ø> (ø) 3.00 <0.00> (ø)
...e/src/main/java/com/google/cloud/storage/Blob.java 81.97% <0.00%> (ø) 29.00% <0.00%> (ø%)

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 41b6ad3...490505c. Read the comment docs.

@gcf-merge-on-green gcf-merge-on-green bot merged commit 50e5938 into googleapis:master Apr 17, 2020
@dmitry-fa dmitry-fa deleted the legacyStorageClasses branch June 26, 2020 07:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
automerge Merge the pull request once unit tests and other checks pass. cla: yes This human has signed the Contributor License Agreement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

docs: label legacy Storage Classes in documentation
4 participants