1 files changed, 34 insertions, 0 deletions
diff --git a/themes/docsy/README.md b/themes/docsy/README.md
new file mode 100644
index 000000000..f61eff67c
--- /dev/null
+++ b/themes/docsy/README.md
@@ -0,0 +1,34 @@
+# Docsy
+
+Docsy is a Hugo theme for technical documentation sets, providing simple navigation, site structure, and more.
+
+You can find an example project that uses Docsy in the [Docsy Example Project repo](https://github.com/google/docsy-example). The Docsy Example Project is hosted at [https://testydocsy.netlify.com/](https://testydocsy.netlify.com/), where you can find detailed theme instructions under **Documentation -> Getting Started**.
+
+To use the Docsy theme, you can either:
+
+* Copy and edit the example site’s repo, which will also give you a skeleton structure for your top-level and documentation sections, or
+* Specify the Docsy theme like any other [Hugo theme](https://gohugo.io/themes/installing-and-using-themes/)
+ when creating or updating your site. This gives you all the theme-y goodness but you’ll need to specify your own site structure.
+
+This is not an officially supported Google product. This project is currently maintained.
+
+## Installation and prerequisites
+
+You need a recent version of Hugo to build sites using this theme (preferably 0.45+). If you install from the [release page](https://github.com/gohugoio/hugo/releases), make sure to get the `extended` Hugo version which supports SCSS. Alternatively, on macOS you can install Hugo via Brew.
+
+If you want to do stylesheet changes, you will also need `PostCSS` to create the final assets. You can also install it locally with:
+
+```
+npm install
+````
+
+To use a local version of the theme files, clone the repo using:
+
+```
+git clone --recurse-submodules --depth 1 https://github.com/google/docsy.git
+```
+
+## Theme documentation
+
+Detailed documentation for this theme is in the Docsy Example Project under **Documentation -> Getting Started**.
+The Docsy Example Project is on [GitHub](https://github.com/google/docsy-example) and is hosted at [https://testydocsy.netlify.com/](https://testydocsy.netlify.com/).