From f0cacecc06ab8d9dc46ad3cd57d29d8fe52e7cf4 Mon Sep 17 00:00:00 2001
From: Karen Bradshaw <kbhawkey@gmail.com>
Date: Tue, 30 Jun 2020 16:08:32 -0400
Subject: [PATCH] add info about updating docsy theme

---
 README.md | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 4c631b0dc8..7c4809287f 100644
--- a/README.md
+++ b/README.md
@@ -8,12 +8,27 @@ This repository contains the assets required to build the [Kubernetes website an
 
 See the [official Hugo documentation](https://gohugo.io/getting-started/installing/) for Hugo installation instructions. Make sure to install the Hugo extended version specified by the `HUGO_VERSION` environment variable in the [`netlify.toml`](netlify.toml#L10) file.
 
-To run the website locally when you have Hugo installed:
+Before building the site, clone the Kubernetes website repository:
 
 ```bash
 git clone https://github.com/kubernetes/website.git
 cd website
-git submodule update --init --recursive
+git submodule update --init --recursive --depth 1
+```
+
+**Note:**  The Kubernetes website deploys the [Docsy Hugo theme](https://github.com/google/docsy#readme).
+If you have not updated your website repository, the `website/themes/docsy` directory is empty. The site cannot build
+without a local copy of the theme.
+
+Update the website theme:
+
+```bash
+git submodule update --init --recursive --depth 1
+```
+
+To build and test the site locally, run:
+
+```bash
 hugo server --buildFuture
 ```