Skip to content

term: must vs. should#1692

Merged
jorgeorpinel merged 8 commits into
masterfrom
term/should-must
Aug 16, 2020
Merged

term: must vs. should#1692
jorgeorpinel merged 8 commits into
masterfrom
term/should-must

Conversation

@jorgeorpinel
Copy link
Copy Markdown
Contributor

@jorgeorpinel jorgeorpinel commented Aug 12, 2020

Non-extensive in the case of "should" — there's too many instances.

+ some copy edits around the instances I did review (even if they weren't changed, e.g. a small improvement to the remote add ref)

@shcheklein shcheklein temporarily deployed to dvc-landing-term-should-ya8p5g August 12, 2020 22:28 Inactive
Comment thread content/docs/command-reference/gc.md
Comment thread content/docs/command-reference/install.md Outdated
Comment thread content/docs/command-reference/remote/add.md Outdated
Comment thread content/docs/install/macos.md
@jorgeorpinel jorgeorpinel marked this pull request as ready for review August 12, 2020 22:57
Comment thread content/docs/user-guide/setup-google-drive-remote.md
Comment thread content/docs/user-guide/privacy.md Outdated
DVC can help you get a token by guiding you through the OAuth flow in the
browser. There you must consent to allow the _DVC_ Application to operate on
your behalf. The OAuth consent screen will describe the scope of what is being
browser. From there you can allow the _DVC_ Application to operate on your
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

let's not change this legal language

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

OK, changes undone. Should I avoid touching this file completely going fwd?

Comment thread content/docs/user-guide/privacy.md Outdated
Comment thread content/docs/command-reference/remote/modify.md Outdated
@jorgeorpinel jorgeorpinel temporarily deployed to dvc-landing-term-should-ya8p5g August 15, 2020 20:46 Inactive
@jorgeorpinel jorgeorpinel temporarily deployed to dvc-landing-term-should-ya8p5g August 15, 2020 20:47 Inactive
@jorgeorpinel jorgeorpinel temporarily deployed to dvc-landing-term-should-ya8p5g August 15, 2020 20:54 Inactive
@jorgeorpinel jorgeorpinel temporarily deployed to dvc-landing-term-should-ya8p5g August 15, 2020 21:01 Inactive
(e.g. [Minio](https://min.io/),
[DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/),
[IBM Cloud Object Storage](https://www.ibm.com/cloud/object-storage) etc.) you
must explicitly configure the `endpointurl`:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

not sure about this one ... you must do this indeed

Copy link
Copy Markdown
Contributor Author

@jorgeorpinel jorgeorpinel Aug 16, 2020

Choose a reason for hiding this comment

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

Yes, that's what this says (it's just a long sentence): "To communicate with ... an S3 compatible API ... configure the remote's endpointurl explicitly". "Must" is very emphatic, I don't think we needed it here. It's still an imperative sentence, which tells you what you must do.

Comment thread content/docs/command-reference/remote/add.md Outdated
Copy link
Copy Markdown
Contributor

@shcheklein shcheklein left a comment

Choose a reason for hiding this comment

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

approved ... just a few last comments

@jorgeorpinel

This comment has been minimized.

@jorgeorpinel jorgeorpinel temporarily deployed to dvc-landing-term-should-ya8p5g August 16, 2020 01:55 Inactive
@jorgeorpinel jorgeorpinel merged commit e656878 into master Aug 16, 2020
@jorgeorpinel jorgeorpinel deleted the term/should-must branch August 20, 2020 22:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants