This is a...

• Feature Request
• Bug Report

Problem:

No overarching Concept guide for controllers.

Proposed Solution:

Write one.

Page to Update:
New page to be added.

We have Concept docs for various controllers:

• docs/concepts/workloads/controllers/deployment.md
• docs/concepts/workloads/controllers/daemonset.md
• docs/concepts/workloads/controllers/replicaset.md
• docs/concepts/workloads/controllers/replicationcontroller.md
• docs/concepts/workloads/controllers/statefulset.md

We have Tasks for types of applications:

• docs/tasks/run-application/run-single-instance-stateful-application.md
• docs/tasks/run-application/run-stateless-application-deployment.md
• docs/tasks/run-application/run-replicated-stateful-application.md

We do not have an overarching doc that covers the following use cases:

• To define what we mean by the word controller.
• To help the users select the right one
• To explain concepts common to all controllers.
• To explain that there are built-in controllers, but that users can write their own (Operators).

@kubernetes/sig-apps-feature-requests