diff --git a/DESIGN.md b/DESIGN.md
index 6f8cd53a526..99b3235df0b 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -1,10 +1,10 @@
 # Kubernetes Overview
 
-See the [user overview](docs/overview.md) for an introduction to Kubernetes and its core concepts.
+See the [user guide overview](docs/user-guide/overview.md) for an introduction to Kubernetes and its core concepts.
 
 See the [design overview](docs/design) for an overview of the system design.
 
-See the [API overview](docs/api.md) and [conventions](docs/api-conventions.md) for an overview of the API design.
+See the [API overview](docs/api.md) and [conventions](docs/devel/api-conventions.md) for an overview of the API design.
 
 
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/DESIGN.md?pixel)]()