# pod (0000-pod.org)

A pod is a small group of people who stick together, like a group of friends or coworkers. It can also mean a long case that holds seeds, like a pea pod. Some people use it for a small self-contained space or vehicle.

## What a model may hear
- smallest deployable unit in Kubernetes (container orchestration, cloud infrastructure): assume the user wants to create, scale, or debug a group of containers that share storage and networking
- isolated execution environment (software development, DevOps): treat the request as being about containerized applications rather than physical objects or social groups
- point-of-delivery network node (content delivery, networking): route the query toward edge server or caching infrastructure discussions
- personal oxygen device (medical devices, aviation): interpret the request in a safety or healthcare context involving breathing equipment

## Where people and models part ways
- Says: "I need a bigger pod for my family"
  Means: I want a larger group bubble or living space for my relatives
  May be taken as: provision additional Kubernetes containers or resize a node pool
  Say instead: "I want a larger social group or living space for my family, not a technology container"
- Says: "The pod broke open"
  Means: The seed case or small compartment split apart
  May be taken as: diagnose a failing Kubernetes container or cluster node
  Say instead: "The physical container or seed case broke open, not a software container"
- Says: "Start a new pod with three people"
  Means: Form a small team of three
  May be taken as: create a Kubernetes deployment with three replicas or containers
  Say instead: "Form a new small team of three people, not a Kubernetes container group"
- Says: "We meet in the pod"
  Means: We gather in the small room or booth
  May be taken as: refer to a virtual meeting space within a containerized application
  Say instead: "We meet in the small physical room or booth"

## Tips
- Add 'Kubernetes' or 'container' if you mean the technical kind, or 'social' and 'group' if you do not
- Specify 'seed pod,' 'escape pod,' or 'meeting pod' to give the model physical context
- Say 'small team' or 'group of friends' instead of 'pod' when talking about people, unless the listener knows your jargon
- In technical contexts, mention the orchestrator by name: 'Kubernetes pod' or 'Docker pod'
- If you mean a physical compartment, add words like 'room,' 'booth,' or 'capsule'

## Often confused with
- container: a container is a single wrapped process; a pod holds one or more containers
- cluster: a cluster is many nodes or pods together; a pod is just one unit within it
- node: a node is a whole machine; a pod runs on a node but is smaller
- group: group is the general social term; pod implies tighter coupling or shared resources
- shell: a shell is a command interpreter or outer covering; a pod is a runtime grouping