Removed all mentions of "please" from docs and messages

ggracechoi · thaJeztah · commit e06ef800fc9b · 2024-06-11T16:53:40.000+02:00
Signed-off-by: Grace Choi &lt;gracechoi@utexas.edu&gt;
Signed-off-by: Pranjal Rai &lt;pranjalrai@utexas.edu&gt;
Signed-off-by: Sebastiaan van Stijn &lt;github@gone.nl&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -8,12 +8,12 @@ body:
     attributes:
       value: |
         Thank you for taking the time to report a bug!
-        If this is a security issue please report it to the [Docker Security team](mailto:security@docker.com).
+        If this is a security issue report it to the [Docker Security team](mailto:security@docker.com).
   - type: textarea
     id: description
     attributes:
       label: Description
-      description: Please give a clear and concise description of the bug
+      description: Give a clear and concise description of the bug
     validations:
       required: true
   - type: textarea
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -4,7 +4,7 @@ contact_links:
     about: "Read guidelines and tips about contributing to Docker."
     url: "https://github.com/docker/cli/blob/master/CONTRIBUTING.md"
   - name: "Security and Vulnerabilities"
-    about: "Please report any security issues or vulnerabilities responsibly to the Docker security team. Please do not use the public issue tracker."
+    about: "Report any security issues or vulnerabilities responsibly to the Docker security team. Do not use the public issue tracker."
     url: "https://github.com/moby/moby/security/policy"
   - name: "General Support"
     about: "Get the help you need to build, share, and run your Docker applications"
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,5 +1,5 @@
 <!--
-Please make sure you've read and understood our contributing guidelines;
+Make sure you've read and understood our contributing guidelines;
 https://github.com/docker/cli/blob/master/CONTRIBUTING.md
 
 ** Make sure all your commits include a signature generated with `git commit -s` **
@@ -10,7 +10,7 @@ guide https://docs.docker.com/opensource/code/
 If this is a bug fix, make sure your description includes "fixes #xxxx", or
 "closes #xxxx"
 
-Please provide the following information:
+Provide the following information:
 -->
 
 **- What I did**
diff --git a/.github/workflows/validate-pr.yml b/.github/workflows/validate-pr.yml
@@ -32,7 +32,7 @@ jobs:
           desc=$(echo "$block" |  awk NF)
 
           if [ -z "$desc" ]; then
-            echo "::error::Changelog section is empty. Please provide a description for the changelog."
+            echo "::error::Changelog section is empty. Provide a description for the changelog."
             exit 1
           fi
 
diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,5 @@
 # if you want to ignore files created by your editor/tools,
-# please consider a global .gitignore https://help.github.com/articles/ignoring-files
+# consider a global .gitignore https://help.github.com/articles/ignoring-files
 *.exe
 *.exe~
 *.orig
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -16,9 +16,9 @@ start participating.
 ## Reporting security issues
 
 The Docker maintainers take security seriously. If you discover a security
-issue, please bring it to their attention right away!
+issue, bring it to their attention right away!
 
-Please **DO NOT** file a public issue, instead send your report privately to
+**DO NOT** file a public issue, instead send your report privately to
 [security@docker.com](mailto:security@docker.com).
 
 Security reports are greatly appreciated and we will publicly thank you for it.
@@ -39,7 +39,7 @@ If you find a match, you can use the "subscribe" button to get notified on
 updates. Do *not* leave random "+1" or "I have this too" comments, as they
 only clutter the discussion, and don't help resolving it. However, if you
 have ways to reproduce the issue or have additional information that may help
-resolving the issue, please leave a comment.
+resolving the issue, leave a comment.
 
 When reporting issues, always include:
 
@@ -166,10 +166,10 @@ Include an issue reference like `Closes #XXXX` or `Fixes #XXXX` in the pull requ
 description that close an issue. Including references automatically closes the issue
 on a merge.
 
-Please do not add yourself to the `AUTHORS` file, as it is regenerated regularly
+Do not add yourself to the `AUTHORS` file, as it is regenerated regularly
 from the Git history.
 
-Please see the [Coding Style](#coding-style) for further guidelines.
+See the [Coding Style](#coding-style) for further guidelines.
 
 ### Merge approval
 
@@ -269,8 +269,8 @@ guidelines for the community as a whole:
 
 * Stay on topic: Make sure that you are posting to the correct channel and
   avoid off-topic discussions. Remember when you update an issue or respond
-  to an email you are potentially sending to a large number of people. Please
-  consider this before you update. Also remember that nobody likes spam.
+  to an email you are potentially sending to a large number of people. Consider
+  this before you update. Also remember that nobody likes spam.
 
 * Don't send email to the maintainers: There's no need to send email to the
   maintainers to ask them to investigate an issue or to take a look at a
diff --git a/NOTICE b/NOTICE
@@ -14,6 +14,6 @@ United States and other governments.
 It is your responsibility to ensure that your use and/or transfer does not
 violate applicable laws.
 
-For more information, please see https://www.bis.doc.gov
+For more information, see https://www.bis.doc.gov
 
 See also https://www.apache.org/dev/crypto.html and/or seek legal counsel.
diff --git a/README.md b/README.md
@@ -67,15 +67,15 @@ make -f docker.Makefile shell
 ## Legal
 
 *Brought to you courtesy of our legal counsel. For more context,
-please see the [NOTICE](https://github.com/docker/cli/blob/master/NOTICE) document in this repo.*
+see the [NOTICE](https://github.com/docker/cli/blob/master/NOTICE) document in this repo.*
 
 Use and transfer of Docker may be subject to certain restrictions by the
 United States and other governments.
 
 It is your responsibility to ensure that your use and/or transfer does not
 violate applicable laws.
 
-For more information, please see https://www.bis.doc.gov
+For more information, see https://www.bis.doc.gov
 
 ## Licensing
 
diff --git a/cli/cobra.go b/cli/cobra.go
@@ -54,7 +54,7 @@ func setupCommonRootCommand(rootCmd *cobra.Command) (*cliflags.ClientOptions, *c
 	rootCmd.SetHelpCommand(helpCommand)
 
 	rootCmd.PersistentFlags().BoolP("help", "h", false, "Print usage")
-	rootCmd.PersistentFlags().MarkShorthandDeprecated("help", "please use --help")
+	rootCmd.PersistentFlags().MarkShorthandDeprecated("help", "use --help")
 	rootCmd.PersistentFlags().Lookup("help").Hidden = true
 
 	rootCmd.Annotations = map[string]string{
diff --git a/cli/command/cli.go b/cli/command/cli.go
@@ -546,7 +546,7 @@ func getServerHost(hosts []string, tlsOptions *tlsconfig.Options) (string, error
 	case 1:
 		host = hosts[0]
 	default:
-		return "", errors.New("Please specify only one -H")
+		return "", errors.New("Specify only one -H")
 	}
 
 	return dopts.ParseHost(tlsOptions != nil, host)
diff --git a/cli/command/context/export.go b/cli/command/context/export.go
@@ -42,7 +42,7 @@ func writeTo(dockerCli command.Cli, reader io.Reader, dest string) error {
 	var printDest bool
 	if dest == "-" {
 		if dockerCli.Out().IsTerminal() {
-			return errors.New("cowardly refusing to export to a terminal, please specify a file path")
+			return errors.New("cowardly refusing to export to a terminal, specify a file path")
 		}
 		writer = dockerCli.Out()
 	} else {
diff --git a/cli/command/image/trust.go b/cli/command/image/trust.go
@@ -100,7 +100,7 @@ func PushTrustedReference(ioStreams command.Streams, repoInfo *registry.Reposito
 	}
 
 	if target == nil {
-		return errors.Errorf("no targets found, please provide a specific tag in order to sign it")
+		return errors.Errorf("no targets found, provide a specific tag in order to sign it")
 	}
 
 	fmt.Fprintln(ioStreams.Out(), "Signing and pushing trust metadata")
diff --git a/cli/command/registry.go b/cli/command/registry.go
@@ -29,7 +29,7 @@ const patSuggest = "You can log in with your password or a Personal Access " +
 // for the given command.
 func RegistryAuthenticationPrivilegedFunc(cli Cli, index *registrytypes.IndexInfo, cmdName string) types.RequestPrivilegeFunc {
 	return func(ctx context.Context) (string, error) {
-		fmt.Fprintf(cli.Out(), "\nPlease login prior to %s:\n", cmdName)
+		fmt.Fprintf(cli.Out(), "\nLogin prior to %s:\n", cmdName)
 		indexServer := registry.GetAuthConfigKey(index)
 		isDefaultRegistry := indexServer == registry.IndexServer
 		authConfig, err := GetDefaultAuthConfig(cli.ConfigFile(), true, indexServer, isDefaultRegistry)
diff --git a/cli/command/stack/config_test.go b/cli/command/stack/config_test.go
@@ -14,7 +14,7 @@ func TestConfigWithEmptyComposeFile(t *testing.T) {
 	cmd := newConfigCommand(test.NewFakeCli(&fakeClient{}))
 	cmd.SetOut(io.Discard)
 
-	assert.ErrorContains(t, cmd.Execute(), `Please specify a Compose file`)
+	assert.ErrorContains(t, cmd.Execute(), `Specify a Compose file`)
 }
 
 func TestConfigMergeInterpolation(t *testing.T) {
diff --git a/cli/command/stack/loader/loader.go b/cli/command/stack/loader/loader.go
@@ -76,7 +76,7 @@ func GetConfigDetails(composefiles []string, stdin io.Reader) (composetypes.Conf
 	var details composetypes.ConfigDetails
 
 	if len(composefiles) == 0 {
-		return details, errors.New("Please specify a Compose file (with --compose-file)")
+		return details, errors.New("Specify a Compose file (with --compose-file)")
 	}
 
 	if composefiles[0] == "-" && len(composefiles) == 1 {
diff --git a/cli/command/swarm/testdata/init-init-autolock.golden b/cli/command/swarm/testdata/init-init-autolock.golden
@@ -7,5 +7,5 @@ command and provide the following key:
 
     unlock-key
 
-Please remember to store this key in a password manager, since without it you
+Remember to store this key in a password manager, since without it you
 will not be able to restart the manager.
diff --git a/cli/command/swarm/testdata/unlockkeys-unlock-key-rotate.golden b/cli/command/swarm/testdata/unlockkeys-unlock-key-rotate.golden
@@ -5,5 +5,5 @@ command and provide the following key:
 
     unlock-key
 
-Please remember to store this key in a password manager, since without it you
+Remember to store this key in a password manager, since without it you
 will not be able to restart the manager.
diff --git a/cli/command/swarm/testdata/unlockkeys-unlock-key.golden b/cli/command/swarm/testdata/unlockkeys-unlock-key.golden
@@ -3,5 +3,5 @@ command and provide the following key:
 
     unlock-key
 
-Please remember to store this key in a password manager, since without it you
+Remember to store this key in a password manager, since without it you
 will not be able to restart the manager.
diff --git a/cli/command/swarm/testdata/update-autolock-unlock-key.golden b/cli/command/swarm/testdata/update-autolock-unlock-key.golden
@@ -4,5 +4,5 @@ command and provide the following key:
 
     unlock-key
 
-Please remember to store this key in a password manager, since without it you
+Remember to store this key in a password manager, since without it you
 will not be able to restart the manager.
diff --git a/cli/command/swarm/unlock.go b/cli/command/swarm/unlock.go
@@ -54,7 +54,7 @@ func runUnlock(ctx context.Context, dockerCli command.Cli) error {
 		return errors.New("Error: swarm is not locked")
 	}
 
-	key, err := readKey(dockerCli.In(), "Please enter unlock key: ")
+	key, err := readKey(dockerCli.In(), "Enter unlock key: ")
 	if err != nil {
 		return err
 	}
diff --git a/cli/command/swarm/unlock_key.go b/cli/command/swarm/unlock_key.go
@@ -88,7 +88,7 @@ func printUnlockCommand(out io.Writer, unlockKey string) {
 	if len(unlockKey) > 0 {
 		fmt.Fprintf(out, "To unlock a swarm manager after it restarts, "+
 			"run the `docker swarm unlock`\ncommand and provide the following key:\n\n    %s\n\n"+
-			"Please remember to store this key in a password manager, since without it you\n"+
+			"Remember to store this key in a password manager, since without it you\n"+
 			"will not be able to restart the manager.\n", unlockKey)
 	}
 }
diff --git a/cli/command/trust/revoke.go b/cli/command/trust/revoke.go
@@ -44,7 +44,7 @@ func revokeTrust(ctx context.Context, dockerCLI command.Cli, remote string, opti
 		return errors.New("cannot use a digest reference for IMAGE:TAG")
 	}
 	if imgRefAndAuth.Tag() == "" && !options.forceYes {
-		deleteRemote, err := command.PromptForConfirmation(ctx, dockerCLI.In(), dockerCLI.Out(), fmt.Sprintf("Please confirm you would like to delete all signature data for %s?", remote))
+		deleteRemote, err := command.PromptForConfirmation(ctx, dockerCLI.In(), dockerCLI.Out(), fmt.Sprintf("Confirm you would like to delete all signature data for %s?", remote))
 		if err != nil {
 			return err
 		}
diff --git a/cli/command/trust/revoke_test.go b/cli/command/trust/revoke_test.go
@@ -70,7 +70,7 @@ func TestTrustRevokeCommand(t *testing.T) {
 			doc:              "OfflineErrors_Confirm",
 			notaryRepository: notary.GetOfflineNotaryRepository,
 			args:             []string{"reg-name.io/image"},
-			expectedMessage:  "Please confirm you would like to delete all signature data for reg-name.io/image? [y/N] ",
+			expectedMessage:  "Confirm you would like to delete all signature data for reg-name.io/image? [y/N] ",
 			expectedErr:      revokeCancelledError,
 		},
 		{
@@ -89,7 +89,7 @@ func TestTrustRevokeCommand(t *testing.T) {
 			doc:              "UninitializedErrors_Confirm",
 			notaryRepository: notary.GetUninitializedNotaryRepository,
 			args:             []string{"reg-name.io/image"},
-			expectedMessage:  "Please confirm you would like to delete all signature data for reg-name.io/image? [y/N] ",
+			expectedMessage:  "Confirm you would like to delete all signature data for reg-name.io/image? [y/N] ",
 			expectedErr:      revokeCancelledError,
 		},
 		{
@@ -108,7 +108,7 @@ func TestTrustRevokeCommand(t *testing.T) {
 			doc:              "EmptyNotaryRepo_Confirm",
 			notaryRepository: notary.GetEmptyTargetsNotaryRepository,
 			args:             []string{"reg-name.io/image"},
-			expectedMessage:  "Please confirm you would like to delete all signature data for reg-name.io/image? [y/N] ",
+			expectedMessage:  "Confirm you would like to delete all signature data for reg-name.io/image? [y/N] ",
 			expectedErr:      revokeCancelledError,
 		},
 		{
@@ -127,7 +127,7 @@ func TestTrustRevokeCommand(t *testing.T) {
 			doc:              "AllSigConfirmation",
 			notaryRepository: notary.GetEmptyTargetsNotaryRepository,
 			args:             []string{"alpine"},
-			expectedMessage:  "Please confirm you would like to delete all signature data for alpine? [y/N] ",
+			expectedMessage:  "Confirm you would like to delete all signature data for alpine? [y/N] ",
 			expectedErr:      revokeCancelledError,
 		},
 	}
diff --git a/cli/command/trust/signer_add.go b/cli/command/trust/signer_add.go
@@ -53,7 +53,7 @@ func addSigner(ctx context.Context, dockerCLI command.Cli, options signerAddOpti
 		return fmt.Errorf("signer name \"%s\" must start with lowercase alphanumeric characters and can include \"-\" or \"_\" after the first character", signerName)
 	}
 	if signerName == "releases" {
-		return errors.New("releases is a reserved keyword, please use a different signer name")
+		return errors.New("releases is a reserved keyword, use a different signer name")
 	}
 
 	if options.keys.Len() == 0 {
diff --git a/cli/command/trust/signer_add_test.go b/cli/command/trust/signer_add_test.go
@@ -34,7 +34,7 @@ func TestTrustSignerAddErrors(t *testing.T) {
 		{
 			name:          "reserved-releases-signer-add",
 			args:          []string{"releases", "my-image", "--key", "/path/to/key"},
-			expectedError: "releases is a reserved keyword, please use a different signer name",
+			expectedError: "releases is a reserved keyword, use a different signer name",
 		},
 		{
 			name:          "disallowed-chars",
diff --git a/cli/command/trust/testdata/trust-revoke-prompt-termination.golden b/cli/command/trust/testdata/trust-revoke-prompt-termination.golden
@@ -1 +1 @@
-Please confirm you would like to delete all signature data for example/trust-demo? [y/N] 
+Confirm you would like to delete all signature data for example/trust-demo? [y/N] 
diff --git a/cli/connhelper/commandconn/commandconn.go b/cli/connhelper/commandconn/commandconn.go
@@ -149,7 +149,7 @@ func (c *commandConn) handleEOF(err error) error {
 	c.stderrMu.Lock()
 	stderr := c.stderr.String()
 	c.stderrMu.Unlock()
-	return errors.Errorf("command %v has exited with %v, please make sure the URL is valid, and Docker 18.09 or later is installed on the remote host: stderr=%s", c.cmd.Args, werr, stderr)
+	return errors.Errorf("command %v has exited with %v, make sure the URL is valid, and Docker 18.09 or later is installed on the remote host: stderr=%s", c.cmd.Args, werr, stderr)
 }
 
 func ignorableCloseError(err error) bool {
diff --git a/contrib/completion/bash/docker b/contrib/completion/bash/docker
@@ -63,7 +63,7 @@
 # must have access to the socket for the completions to function correctly
 #
 # Note for developers:
-# Please arrange options sorted alphabetically by long name with the short
+# Arrange options sorted alphabetically by long name with the short
 # options immediately following their corresponding long form.
 # This order should be applied to lists, alternatives and code blocks.
 
diff --git a/dockerfiles/Dockerfile.authors b/dockerfiles/Dockerfile.authors
@@ -18,7 +18,7 @@ git add -A
 cp -rf /out/* .
 diff=$(git status --porcelain -- AUTHORS)
 if [ -n "$diff" ]; then
-  echo >&2 'ERROR: Authors result differs. Please update with "make -f docker.Makefile authors"'
+  echo >&2 'ERROR: Authors result differs. Update with "make -f docker.Makefile authors"'
   echo "$diff"
   exit 1
 fi
diff --git a/docs/deprecated.md b/docs/deprecated.md
@@ -209,7 +209,8 @@ CLI to use API version 1.23, which produces an error:
 
 ```console
 DOCKER_API_VERSION=1.23 docker version
-Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24, please upgrade your client to a newer version
+Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24, 
+upgrade your client to a newer version
 ```
 
 An environment variable (`DOCKER_MIN_API_VERSION`) is introduced that allows
@@ -611,7 +612,7 @@ The `--log-opt fluentd-async-connect` option for the fluentd logging driver is
 A deprecation message is logged in the daemon logs if the old option is used:
 
 ```console
-fluent#New: AsyncConnect is now deprecated, please use Async instead
+fluent#New: AsyncConnect is now deprecated, use Async instead
 ```
 
 Users are encouraged to use the `fluentd-async` option going forward, as support
diff --git a/docs/extend/EBS_volume.md b/docs/extend/EBS_volume.md
@@ -122,7 +122,7 @@ We have to put the following JSON to `$TMPDIR/config.json`:
 }
 ```
 
-Please note a couple of points:
+Note a couple of points:
 - `PropagatedMount` is needed so that the docker daemon can see mounts done by the
 rexray plugin from within the container, otherwise the docker daemon is not able
 to mount a docker volume.
diff --git a/docs/reference/commandline/container_cp.md b/docs/reference/commandline/container_cp.md
@@ -103,7 +103,7 @@ Copy files from container to local path
 $ docker cp CONTAINER:/var/logs/ /tmp/app_logs
 ```
 
-Copy a file from container to stdout. Please note `cp` command produces a tar stream
+Copy a file from container to stdout. Note `cp` command produces a tar stream
 
 ```console
 $ docker cp CONTAINER:/var/logs/app.log - | tar x -O | grep "ERROR"
diff --git a/docs/reference/commandline/swarm_unlock-key.md b/docs/reference/commandline/swarm_unlock-key.md
@@ -39,7 +39,7 @@ command and provide the following key:
 
     SWMKEY-1-fySn8TY4w5lKcWcJPIpKufejh9hxx5KYwx6XZigx3Q4
 
-Please remember to store this key in a password manager, since without it you
+Remember to store this key in a password manager, since without it you
 will not be able to restart the manager.
 ```
 
@@ -56,7 +56,7 @@ command and provide the following key:
 
     SWMKEY-1-7c37Cc8654o6p38HnroywCi19pllOnGtbdZEgtKxZu8
 
-Please remember to store this key in a password manager, since without it you
+Remember to store this key in a password manager, since without it you
 will not be able to restart the manager.
 ```
 
diff --git a/docs/reference/commandline/swarm_unlock.md b/docs/reference/commandline/swarm_unlock.md
@@ -24,7 +24,7 @@ enabled, and is also available from the `docker swarm unlock-key` command.
 
 ```console
 $ docker swarm unlock
-Please enter unlock key:
+Enter unlock key:
 ```
 
 ## Related commands
diff --git a/docs/reference/commandline/trust_revoke.md b/docs/reference/commandline/trust_revoke.md
diff --git a/e2e/cli-plugins/flags_test.go b/e2e/cli-plugins/flags_test.go
diff --git a/e2e/cli-plugins/run_test.go b/e2e/cli-plugins/run_test.go
diff --git a/experimental/README.md b/experimental/README.md
diff --git a/man/docker.1.md b/man/docker.1.md
diff --git a/man/dockerd.8.md b/man/dockerd.8.md
diff --git a/man/src/system/events.md b/man/src/system/events.md
diff --git a/scripts/vendor b/scripts/vendor
