Kubernetes API Conventions

1. Types (kinds)

   Resources, objects, lists and simple kinds.

2. Verbs on resources

   GET, LIST, POST, PUT, PATCH, DELETE and WATCH semantics.

3. Patch operations

   JSON Patch, merge patch, strategic merge patch and apply.

4. Idempotency

   Idempotent operations and generateName.

5. Optional vs required

   Field optionality and omitempty rules.

6. Defaulting

   Static, admission and controller-assigned defaults.

7. Concurrency control and consistency

   resourceVersion and optimistic concurrency.

8. Object references

   Naming and shape of reference fields.

9. HTTP status codes

   Status codes used by the API server.

10. Events

    Event objects and reasons.

11. Spec and status

    Declarative desired state vs observed status.

12. API concepts

    Watch, chunking, server-side apply and resource versions.

Each section links to the official page. Titles and summaries by Extra Credit; the docs belong to their authors.