From ddfcad4fe8f7a4eaae687a65f34fe84c47269412 Mon Sep 17 00:00:00 2001
From: Tim Bannister <tim@scalefactory.com>
Date: Sat, 29 Oct 2022 18:14:31 +0100
Subject: [PATCH] Redo index for Containers concept

- Mention RuntimeClass
- omit container image and runtimeclass from links as they are already
  mentioned explicitly

Co-authored-by: Rey Lejano <rlejano@gmail.com>
---
 content/en/docs/concepts/containers/_index.md   | 17 +++++++++++------
 content/en/docs/concepts/containers/images.md   |  1 +
 .../docs/concepts/containers/runtime-class.md   |  1 +
 3 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/content/en/docs/concepts/containers/_index.md b/content/en/docs/concepts/containers/_index.md
index 746e1b7fc9ade..8c681ae454b59 100644
--- a/content/en/docs/concepts/containers/_index.md
+++ b/content/en/docs/concepts/containers/_index.md
@@ -6,7 +6,6 @@ reviewers:
 - erictune
 - thockin
 content_type: concept
-no_list: true
 ---
 
 <!-- overview -->
@@ -18,7 +17,10 @@ run it.
 Containers decouple applications from underlying host infrastructure.
 This makes deployment easier in different cloud or OS environments.
 
-
+Each {{< glossary_tooltip text="node" term_id="node" >}} in a Kubernetes
+cluster runs the containers that form the
+[Pods](/docs/concepts/workloads/pods/) assigned to that node.
+Containers in a Pod are co-located and co-scheduled to run on the same node.
 
 
 <!-- body -->
@@ -38,8 +40,11 @@ the change, then recreate the container to start from the updated image.
 
 {{< glossary_definition term_id="container-runtime" length="all" >}}
 
-## {{% heading "whatsnext" %}}
-
-* Read about [container images](/docs/concepts/containers/images/)
-* Read about [Pods](/docs/concepts/workloads/pods/)
+Usually, you can allow your cluster to pick the default container runtime
+for a Pod. If you need to use more than one container runtime in your cluster,
+you can specify the [RuntimeClass](/docs/concepts/containers/runtime-class/)
+for a Pod to make sure that Kubernetes runs those containers using a
+particular container runtime.
 
+You can also use RuntimeClass to run different Pods with the same container
+runtime but with different settings.
diff --git a/content/en/docs/concepts/containers/images.md b/content/en/docs/concepts/containers/images.md
index c696fbb3ea33d..5cdef177df2d2 100644
--- a/content/en/docs/concepts/containers/images.md
+++ b/content/en/docs/concepts/containers/images.md
@@ -5,6 +5,7 @@ reviewers:
 title: Images
 content_type: concept
 weight: 10
+hide_summary: true # Listed separately in section index
 ---
 
 <!-- overview -->
diff --git a/content/en/docs/concepts/containers/runtime-class.md b/content/en/docs/concepts/containers/runtime-class.md
index ff4bbcd57a653..b43bde9a2fc40 100644
--- a/content/en/docs/concepts/containers/runtime-class.md
+++ b/content/en/docs/concepts/containers/runtime-class.md
@@ -5,6 +5,7 @@ reviewers:
 title: Runtime Class
 content_type: concept
 weight: 30
+hide_summary: true # Listed separately in section index
 ---
 
 <!-- overview -->