<p dir="auto">A number of examples spread across various documentation pages still speak of replication controllers where they should instead say replica sets. Many of these are of an introductory nature and thus tend to confuse Kubernetes newcomers in particular (as determined anecdotally by the number of Slack questions I personally see getting posted in this regard). One particular use case is the application of the <code class="notranslate">kubectl run</code> command which is often accompanied by telling the reader to run <code class="notranslate">kubectl get rc</code> to see the created replication controllers afterwards where instead it should be <code class="notranslate">kubectl get rs</code> these days to list replica sets.</p>
<p dir="auto">All such occurrences should be updated accordingly. Specifically, I came across</p>
<ul dir="auto">
<li><a href="http://kubernetes.io/docs/user-guide/simple-nginx/" rel="nofollow">http://kubernetes.io/docs/user-guide/simple-nginx/</a></li>
<li><a href="http://kubernetes.io/docs/user-guide/pods/multi-container/" rel="nofollow">http://kubernetes.io/docs/user-guide/pods/multi-container/</a></li>
<li><a href="http://kubernetes.io/docs/user-guide/walkthrough/k8s201/" rel="nofollow">http://kubernetes.io/docs/user-guide/walkthrough/k8s201/</a></li>
</ul>
<p dir="auto">There may be additional pages though that I'm not aware of.</p>
<p dir="auto">I'd be happy to provide a PR to update the pages above and any others people point out.</p>
<p dir="auto">Thanks.</p>
<p dir="auto">After creating a simple pod on an empty cluster I wan't able to delete it.</p>
<p dir="auto">Way to reproduce:</p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="kubectl run example --image=nginx
kubectl get rc
# empty
kubectl get pods
NAME                       READY     STATUS    RESTARTS   AGE
example-1934187764-swmqv   1/1       Running   0          38s
kubectl delete pod example-1934187764-swmqv

kubectl get pods
NAME                       READY     STATUS              RESTARTS   AGE
example-1934187764-l36b7   0/1       ContainerCreating   0          2s
example-1934187764-swmqv   1/1       Terminating         0          57s
kubectl get pods
NAME                       READY     STATUS    RESTARTS   AGE
example-1934187764-l36b7   1/1       Running   0          6s"><pre class="notranslate"><code class="notranslate">kubectl run example --image=nginx
kubectl get rc
# empty
kubectl get pods
NAME                       READY     STATUS    RESTARTS   AGE
example-1934187764-swmqv   1/1       Running   0          38s
kubectl delete pod example-1934187764-swmqv

kubectl get pods
NAME                       READY     STATUS              RESTARTS   AGE
example-1934187764-l36b7   0/1       ContainerCreating   0          2s
example-1934187764-swmqv   1/1       Terminating         0          57s
kubectl get pods
NAME                       READY     STATUS    RESTARTS   AGE
example-1934187764-l36b7   1/1       Running   0          6s
</code></pre></div>
<p dir="auto">Tested with GKE 1.2 and local vagrant (Mac) 1.2.</p>