Confusing wording in "Declare Network Policy" task page

[botanyhelp]

Suggestion about confusing wording, in particular, this line on page at k8s.io/docs/tasks/administer-cluster/declare-network-policy/ :

Assign the policy to the service

I have two problems with that:

• we are actually creating-the-network-policy-object, not assigning-policy-to-the-service
• mentioning "service" is misleading because Network Policies apply to pods and have nothing to do with Services, there is no way to firewall a service even though it sounds right

NOTICE: I am not a kubernetes expert! Just really enjoying the excellent documentation, thanks!!!

Page: https://k8s.io/docs/tasks/administer-cluster/declare-network-policy/

[k8s-ci-robot]

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[sftim]

/retitle Confusing working in "Declare Network Policy" task page
/language en

[sftim]

How about "Define a network policy that applies to the workload"?

[botanyhelp]

That would be okay. The YAML text shown above the headline is the definition of the Network Policy, so I think changing the confusing headline is needed, especially to remove words "service" and "assign". This is the confusing headline to be replaced:

BAD:
Assign the policy to the service

Good replacements might be:

BETTER OPTIONS:
Apply the Network Policy
Create the NetworkPolicy object

Your suggestion:
"Define a network policy that applies to the workload"
..is an improvement but the policy will apply to pods that match the podSelector criteria, so I like "pod" better than "workload". Network Policies apply to pods, and only pods.

[dhairya-seth]

"Apply the Network Policy to Pods" would be a better option.

[dhairya-seth]

We are applying a Network Policy to Pods, not a Service. This heading will eliminate any confusion and accurately describes the action.

[sftim]

/retitle Confusing wording in "Declare Network Policy" task page

[botanyhelp]

I agree with @dhairya-seth who say:

"Apply the Network Policy to Pods" would be a better option.

Thanks everyone..I do not collaborate on GitHub docs often, your patience is appreciated!