The proposal is to create a collection of tests with the cross linked documentation pages that would demonstrate all interesting behaviors of Pod lifecycle events.

Ideally, docs pages must be at least partially auto-generated off the tests. And tests be cross linked back to the documentation pages.

More details:

• As part of sidecar container KEP we introduced a handy test framework that allows to define the Pod spec and test the sequence of callbacks executed in it: https://github.com/kubernetes/kubernetes/blob/master/test/e2e_node/container_lifecycle_test.go#L155-L164 Today many tests are in a single file, they can be split apart into separate files under subfolder
• We also have an overview diagram that can be used to identify scenarios: https://docs.google.com/presentation/d/1e-qJWe6He2qjt0PFiZtocqP8VbkrwKAI9B4X72L0bGk/edit?resourcekey=0-N77W7Q5UHuN5dFtekjmAIA#slide=id.g209315a2632_0_0 The diagram can be an entry-point in the k8s docs to the repository of those behaviors.

/sig node
/kind cleanup
/area test
/priority backlog