Merge pull request #26723 from shiavm006/docs-fix-kube-play-annotation-flag

docs(kube play): clarify --annotation flag only affects containers, not pods

Author: openshift-merge-bot[bot]

cmd/podman/kube/play.go

@@ -104,7 +104,7 @@ func playFlags(cmd *cobra.Command) {
 	flags.StringArrayVar(
 		&playOptions.annotations,
 		annotationFlagName, []string{},
-		"Add annotations to pods (key=value)",
+		"Add Podman-specific annotations to containers and pods created by Podman (key=value)",
 	)
 	_ = cmd.RegisterFlagCompletionFunc(annotationFlagName, completion.AutocompleteNone)
 	credsFlagName := "creds"

docs/source/markdown/podman-kube-play.1.md.in

@@ -201,6 +201,8 @@ An image can be automatically mounted into a container if the annotation `io.pod
 
 @@option annotation.container
 
+Note: For `podman kube play`, the `--annotation` flag adds Podman-specific annotations to the containers and pods created by Podman, not to the Kubernetes YAML itself. These annotations can be used to configure Podman-specific features like user namespaces (`io.podman.annotations.userns`), volumes-from (`io.podman.annotations.volumes-from`), and other container behaviors.
+
 @@option authfile
 
 #### **--build**