Revise concept & reference docs for Services, Ingress & networking

[sftim]

Overall PR (changes have been split out).

Individual PRs:

• Revise Service documentation #37385
• Redo naming in Service concept #36668
• Move "Connecting Applications with Services" to tutorials section #36669
• Link from Policies concept to NetworkPolicy page #36670
• Reorganize “Services, Load Balancing, and Networking” concept #36671
• Avoid misleading text in Service concept #36672
• Favor EndpointSlice over Endpoints #36673
• Migrate reference details out Service concept #36675
• Improve EndpointSlice concept #37386
• Don't check Kubernetes version for using Service API #37442
• Revise glossary entry for Service #38054
• Drop (deprecated) task for enabling service topology #38055
• Move AWS Service annotation details to reference page #38551
• Tweak virtual ips reference #38561
• Revise introduction to Service page #38562
• Revise Service concept, part 13 #38563
• Revise Service concept, part 14 #39499
• Tweak headings for port definitions within Service concept #40227
• Reorganise part of the Service concept #40671
• Document detail about headless Services #41195

---

The effect of this PR, overall:

• Revise Services documentation [preview]
  • migrate reference details out of Concepts section
  • drop some vendor-specific details that don't fit well with our content guide
  • write “primary” in place of “master”
  • general tidying
• Move Connecting Applications with Services (to tutorials section)
• favor EndpointSlices over Endpoints
• Reorganize the Services, Load Balancing, and Networking section
  • and add page descriptions [preview]
• Remove enabling Service Topology
• Update https://k8s.io/docs/concepts/policy/ to link to the NetworkPolicy docs

/language en
/label refactor
/sig network

Helps with #14770

[netlify]

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	613d6b8
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/649ed8b686967100083399a3
😎 Deploy Preview	https://deploy-preview-30817--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[sftim]

May help with #32013

[chrismetz09]

The service glossary entry ({{< glossary_definition term_id="service" length="short" >}}) does not look right. Perhaps replace with:

Kubernetes defines a Service as a scalable and resilient method for exposing an application service running on one or more pods in your cluster. Kubernetes employs several techniques to enable a service including per-Pod IPv4/IPv6 addressing, dynamic Pod creation and deletion, Pod replicas and service discovery.

[chrismetz09]

In service.md file under #services-in-kubernetes, wondering if micro-service term should be included. What about the abstraction? Isn't it just one piece of a service? A text suggestion:

In Kubernetes, a Service employs an abstraction which defines a logical set of Pods and a policy by which to access these pods.

[sftim]

Also see #41173

[sftim]

/remove-label refactor

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: shannonxtreme
Once this PR has been reviewed and has the lgtm label, please ask for approval from sftim. For more information see the Kubernetes Code Review Process.

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

Needs approval from an approver in each of these files:

• content/en/OWNERS

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

[sftim]

All split out PRs have merged or been superseded.

/close

[k8s-ci-robot]

@sftim: Closed this PR.

In response to this:

All split out PRs have merged or been superseded.

/close

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/test-infra repository.