Split Pod concept into a simple introduction and further details

[shirady]

I think this page needs to be separated, today it includes basic information about pods as well as detailed advanced subjects.

https://k8s.io/docs/concepts/workloads/pods/

This page should include:

• What is a Pod?
• Using Pods: Workload resources for managing pods
• Working with Pods: Pod template
• any basic information

... all the rest are detailed advanced subjects, and if someone did not know what is a pod, he will hardly understand those details.

[sftim]

/retitle Split Pod concept into a simple introduction and further details
/language en
/label refactor

/triage accepted
/priority important-longterm

Yes, we should.

Before starting work on this please reply here to outline your approach, and check that SIG Docs is happy with the approach you're considering.

This is an important change to get right.

[devarsh10]

I would like to contribute to this issue. And would like to seperate begineer concepts and advanced concepts of PODs.
Btw, I'm a begineer in Kubernetes but I'm familiar with pod, deployments, sevice and some of its concepts.

Regards,
Devarsh.

[tengqm]

@devarsh10 A beginner's feelings are more useful when differentiating basic concepts from advanced concepts.
Feel free to assign this to yourself.

[devarsh10]

Okay @tengqm.
/assign

[devarsh10]

I have created rough notes of the points you mentioned.
Please let me know if I am going in right direction or not.

K8s_Pod..pdf

[sftim]

I had a look at the PDF.

I'm afraid that it is a bit hard to understand that's in that fil;e, as the language isn't clear (it's not the kind of English that people speak around me).

I'm worried that I can't work out the intent you have here @devash10, and so it's not easy to confirm that you're going in the right direction.

[devarsh10]

Hey all,
I am sorry for the delayed response.
I had created the notes.
I am attaching a PDF. Please consider reviewing it.

Pod Notes

Regards.

[sftim]

What we'd really like is either an editable document (HackMD, Google Doc) where approvers can make suggestions, or a pull request.

I recommend opening an actual pull request.

[devarsh10]

Hello @sftim,
I apologize for the delayed response. I have prepared the Google Doc, and here's the link to it -> Link

My plan is to make changes to the Kubernetes Pod documentation once the Google Doc is approved. Here's the link to the section I'll be editing: https://kubernetes.io/docs/concepts/workloads/pods/

Please let me know if you have any suggestions or if you think this approach could be improved.

[sftim]

/help

[k8s-ci-robot]

@sftim:
This request has been marked as needing help from a contributor.

Guidelines

Please ensure that the issue body includes answers to the following questions:

• Why are we solving this issue?
• To address this issue, are there any code changes? If there are code changes, what needs to be done in the code and what places can the assignee treat as reference points?
• Does this issue have zero to low barrier of entry?
• How can the assignee reach out to you for help?

For more details on the requirements of such an issue, please see here and ensure that they are met.

If this request no longer meets these requirements, the label can be removed
by commenting with the /remove-help command.

In response to this:

/help

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]

Help, from any contributor, is welcome.