This is a...

• Feature Request
• Bug Report

Problem:
The documentation at https://kubernetes.io/docs/reference/kubectl/conventions/#generators suggests that I should be able to use the generator extensions/v1beta1 much as deployment/v1beta1 as it lists kubectl run --generator=extensions/v1beta1 right next to kubectl run --generator=deployment/v1beta1, with the latter being recommended.

But is the difference really that one is recommended and the other not? kubectl run --generator=deployment/v1beta1 foobar --image=nginx -o yaml --dry-run works but with extensions/v1beta1 you get error: generator "apps/v1beta1" not found (e.g. when running via the interactive environment in https://kubernetes.io/docs/tutorials/kubernetes-basics/create-cluster/cluster-interactive/).

Proposed Solution:
Either remove the non-recommended options or clarify how or when they can be used.

Page to Update:
https://kubernetes.io/docs/reference/kubectl/conventions/#generators