Clean up and implement style guidelines for “Declare Network Policy”

[sharjeelaziz]

• Reworded paragraphs to reduce ambiguity.

[netlify]

Deploy preview for kubernetes-io-master-staging ready!

Built with commit c60ddea

https://deploy-preview-18980--kubernetes-io-master-staging.netlify.com

[sharjeelaziz]

/assign @zparnold

[danwinship]

This is mostly just style fixes and I don't know what the style guide says, but the one addition of technical content is correct.

[sftim]

Hi @sharjeelaziz

Here's some feedback. I recommend making a few tweaks.

[sftim]

I hope it's OK to clarify the PR title:
/retitle Clean up and implement style guidelines for “Declare Network Policy”

[sftim]

My opinion is that this is almost /lgtm. The main thing that I think needs change to make this mergeable is the text blocks that read:

If you don't see a command prompt, try pressing enter.

In some ways, this isn't sample output, and it's a detail that I think is OK to skip. If keeping it in, I would prefix the sample with something like “kubectl displays a hint:”

As this is a cleanup PR, it's not making things worse but it is missing a few things I would prefer to see fixed. Everything below this line is optional to fix (in my opinion) / can wait for a future PR:

1. min-kubernetes-server-version. @sharjeelaziz, have a look at some of the other task pages and you'll see examples of where this is set. Adding that metadata makes the {{< version-check >}} shortcode much more relevant.
2. “And expose it via a service.”—I'd change this to “And expose it via a Service:”
3. If I were updating the page I think I would convert the access-nginx NetworkPolicy into a downloadable resource using {{< codenew >}}

[kbhawkey]

Page preview:
https://deploy-preview-18980--kubernetes-io-master-staging.netlify.com/docs/tasks/administer-cluster/declare-network-policy/

[sftim]

From a quick skim, this looks OK to me.
(not adding /lgtm because that requires a bit more of a careful look)

[kbhawkey]

Thanks @sharjeelaziz . This looks good.
/lgtm

[kbhawkey]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kbhawkey

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• content/en/OWNERS [kbhawkey]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment