Revise docs home page

Reorder and replace cards to better (I hope!) serve our readers.
pull/41987/head
Tim Bannister 2023-07-12 01:25:31 +01:00
parent 8ed514a556
commit 9520b96a61
21 changed files with 57 additions and 32 deletions

View File

@ -8,6 +8,12 @@ content_type: concept
description: >
Lower-level detail relevant to creating or administering a Kubernetes cluster.
no_list: true
card:
name: setup
weight: 60
anchors:
- anchor: "#securing-a-cluster"
title: Securing a cluster
---
<!-- overview -->

View File

@ -6,6 +6,9 @@ reviewers:
- erictune
- thockin
content_type: concept
card:
name: concepts
weight: 50
---
<!-- overview -->

View File

@ -10,6 +10,9 @@ weight: 20
card:
name: concepts
weight: 10
anchors:
- anchor: "#why-you-need-kubernetes-and-what-can-it-do"
title: Why Kubernetes?
no_list: true
---

View File

@ -8,6 +8,7 @@ description: >
plane and a set of machines called nodes.
weight: 30
card:
title: Components of a cluster
name: concepts
weight: 20
---

View File

@ -4,6 +4,10 @@ weight: 55
description: >
Understand Pods, the smallest deployable compute object in Kubernetes, and the higher-level abstractions that help you to run them.
no_list: true
card:
title: Workloads and Pods
name: concepts
weight: 60
---
{{< glossary_definition term_id="workload" length="short" >}}

View File

@ -5,9 +5,6 @@ title: Pods
content_type: concept
weight: 10
no_list: true
card:
name: concepts
weight: 60
---
<!-- overview -->

View File

@ -2,9 +2,6 @@
title: Page content types
content_type: concept
weight: 80
card:
name: contribute
weight: 30
---
<!-- overview -->

View File

@ -4,7 +4,10 @@ content_type: concept
weight: 10
card:
name: contribute
weight: 20
weight: 15
anchors:
- anchor: "#opening-an-issue"
title: Suggest content improvements
---
<!-- overview -->

View File

@ -41,20 +41,20 @@ cards:
description: "Look up common tasks and how to perform them using a short sequence of steps."
button: "View Tasks"
button_path: "/docs/tasks"
- name: training
title: "Training"
description: "Get certified in Kubernetes and make your cloud native projects successful!"
button: "View training"
button_path: "/training"
- name: reference
title: Look up reference information
description: Browse terminology, command line syntax, API resource types, and setup tool documentation.
button: View Reference
button_path: /docs/reference
- name: training
title: "Training"
description: "Get certified in Kubernetes and make your cloud native projects successful!"
button: "View training"
button_path: "/training"
- name: contribute
title: Contribute to the docs
title: Contribute to Kubernetes
description: Anyone can contribute, whether you're new to the project or you've been around a long time.
button: Contribute to the docs
button: Find out how to help
button_path: /docs/contribute
- name: Download
title: Download Kubernetes

View File

@ -5,6 +5,7 @@ weight: 110
no_list: true
card:
name: reference
title: kubectl command line tool
weight: 20
---

View File

@ -7,8 +7,8 @@ reviewers:
content_type: concept
weight: 10 # highlight it
card:
name: reference
weight: 30
name: tasks
weight: 10
---
<!-- overview -->

View File

@ -1,6 +1,10 @@
---
title: "Kubernetes API"
weight: 50
card:
title: Kubernetes API reference
name: reference
weight: 40
---
<!-- overview -->

View File

@ -3,6 +3,12 @@ title: Well-Known Labels, Annotations and Taints
content_type: concept
weight: 40
no_list: true
card:
name: reference
weight: 30
anchors:
- anchor: "#labels-annotations-and-taints-used-on-api-objects"
title: Labels, annotations and taints
---
<!-- overview -->

View File

@ -4,8 +4,9 @@ weight: 10
no_list: true
content_type: concept
card:
name: reference
weight: 40
title: kubeadm command reference
name: setup
weight: 80
---
<img src="/images/kubeadm-stacked-color.png" align="right" width="150px">Kubeadm is a tool built to provide `kubeadm init` and `kubeadm join` as best-practice "fast paths" for creating Kubernetes clusters.

View File

@ -4,7 +4,7 @@ content_type: task
weight: 10
card:
name: setup
weight: 20
weight: 40
title: Install the kubeadm setup tool
---

View File

@ -4,7 +4,8 @@ content_type: task
weight: 30
card:
name: tasks
weight: 40
weight: 25
title: Configure access to clusters
---
<!-- overview -->

View File

@ -7,6 +7,10 @@ reviewers:
- davidopp
content_type: concept
no_list: true
card:
name: tasks
weight: 999
title: Getting help
---
<!-- overview -->

View File

@ -3,6 +3,12 @@ title: "Install Tools"
description: Set up Kubernetes tools on your computer.
weight: 10
no_list: true
card:
name: tasks
weight: 20
anchors:
- anchor: "#kubectl"
title: Install kubectl
---
## kubectl

View File

@ -4,10 +4,6 @@ reviewers:
title: Install and Set Up kubectl on Linux
content_type: task
weight: 10
card:
name: tasks
weight: 20
title: Install kubectl on Linux
---
## {{% heading "prerequisites" %}}

View File

@ -4,10 +4,6 @@ reviewers:
title: Install and Set Up kubectl on macOS
content_type: task
weight: 10
card:
name: tasks
weight: 20
title: Install kubectl on macOS
---
## {{% heading "prerequisites" %}}

View File

@ -4,10 +4,6 @@ reviewers:
title: Install and Set Up kubectl on Windows
content_type: task
weight: 10
card:
name: tasks
weight: 20
title: Install kubectl on Windows
---
## {{% heading "prerequisites" %}}