From 88a6607e399481d50c038218113a85ef685ab5e6 Mon Sep 17 00:00:00 2001
From: "Masaya Aoyama (@amsy810)" <tennis.tenmasa@gmail.com>
Date: Sat, 2 Jun 2018 03:48:55 +0900
Subject: [PATCH] [mod] API overview link is dead (#8733)

NG: https://kubernetes.io/docs/reference/api-overview/
OK: https://kubernetes.io/docs/reference/using-api/api-overview/

For example, this page contain dead link.
https://kubernetes.io/docs/reference/

Old page is this, so its change is correct.
https://v1-9.docs.kubernetes.io/docs/reference/api-overview/

Note:
China page don't have this link.
---
 .../extend-kubernetes/api-extension/custom-resources.md         | 2 +-
 content/en/docs/concepts/overview/what-is-kubernetes.md         | 2 +-
 content/en/docs/reference/_index.md                             | 2 +-
 content/en/docs/reference/using-api/client-libraries.md         | 2 +-
 content/en/docs/reference/using-api/deprecation-policy.md       | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md b/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md
index 3258dd8305..fe30006c6f 100644
--- a/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md
+++ b/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md
@@ -15,7 +15,7 @@ This page explains [*custom resources*](/docs/concepts/api-extension/custom-reso
 {{% capture body %}}
 ## Custom resources
 
-A *resource* is an endpoint in the [Kubernetes API](/docs/reference/api-overview/) that stores a collection of [API objects](/docs/concepts/overview/working-with-objects/kubernetes-objects/) of a certain kind. For example, the built-in *pods* resource contains a collection of Pod objects.
+A *resource* is an endpoint in the [Kubernetes API](/docs/reference/using-api/api-overview/) that stores a collection of [API objects](/docs/concepts/overview/working-with-objects/kubernetes-objects/) of a certain kind. For example, the built-in *pods* resource contains a collection of Pod objects.
 
 A *custom resource* is an extension of the Kubernetes API that is not necessarily available on every
 Kubernetes cluster.
diff --git a/content/en/docs/concepts/overview/what-is-kubernetes.md b/content/en/docs/concepts/overview/what-is-kubernetes.md
index 7699a8916b..3adf53a238 100644
--- a/content/en/docs/concepts/overview/what-is-kubernetes.md
+++ b/content/en/docs/concepts/overview/what-is-kubernetes.md
@@ -58,7 +58,7 @@ tools to checkpoint state.
 
 Additionally, the [Kubernetes control
 plane](/docs/concepts/overview/components/) is built upon the same
-[APIs](/docs/reference/api-overview/) that are available to developers
+[APIs](/docs/reference/using-api/api-overview/) that are available to developers
 and users. Users can write their own controllers, such as
 [schedulers](https://github.com/kubernetes/community/blob/{{< param "githubbranch" >}}/contributors/devel/scheduler.md),
 with [their own
diff --git a/content/en/docs/reference/_index.md b/content/en/docs/reference/_index.md
index 5c79c55d94..493800506e 100644
--- a/content/en/docs/reference/_index.md
+++ b/content/en/docs/reference/_index.md
@@ -9,7 +9,7 @@ weight: 70
 
 ## API Reference
 
-* [Kubernetes API Overview](/docs/reference/api-overview/) - Overview of the API for Kubernetes.
+* [Kubernetes API Overview](/docs/reference/using-api/api-overview/) - Overview of the API for Kubernetes.
 * Kubernetes API Versions
   * [1.10](/docs/reference/generated/kubernetes-api/v1.10/)
   * [1.9](https://v1-9.docs.kubernetes.io/docs/reference/)
diff --git a/content/en/docs/reference/using-api/client-libraries.md b/content/en/docs/reference/using-api/client-libraries.md
index 00902f55ad..1cd609a2b4 100644
--- a/content/en/docs/reference/using-api/client-libraries.md
+++ b/content/en/docs/reference/using-api/client-libraries.md
@@ -12,7 +12,7 @@ API from various programming languages.
 {{% /capture %}}
 
 {{% capture body %}}
-To write applications using the [Kubernetes REST API](/docs/reference/api-overview/),
+To write applications using the [Kubernetes REST API](/docs/reference/using-api/api-overview/),
 you do not need to implement the API calls and request/response types yourself.
 You can use a client library for the programming language you are using.
 
diff --git a/content/en/docs/reference/using-api/deprecation-policy.md b/content/en/docs/reference/using-api/deprecation-policy.md
index 32bb782e1e..2bf41f3b4e 100644
--- a/content/en/docs/reference/using-api/deprecation-policy.md
+++ b/content/en/docs/reference/using-api/deprecation-policy.md
@@ -20,7 +20,7 @@ This document details the deprecation policy for various facets of the system.
 Since Kubernetes is an API-driven system, the API has evolved over time to
 reflect the evolving understanding of the problem space. The Kubernetes API is
 actually a set of APIs, called "API groups", and each API group is
-independently versioned.  [API versions](/docs/reference/api-overview/#api-versioning) fall
+independently versioned.  [API versions](/docs/reference/using-api/api-overview/#api-versioning) fall
 into 3 main tracks, each of which has different policies for deprecation:
 
 | Example  | Track                            |