diff --git a/core/themes/classy/README.txt b/core/themes/classy/README.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a5181239fdc031b42b39e568bae8c3043a787ee4
--- /dev/null
+++ b/core/themes/classy/README.txt
@@ -0,0 +1,17 @@
+ABOUT CLASSY
+-----------
+
+Classy is a base theme that provides many classes in its markup. For cleaner
+markup (fewer classes), the default Stable base theme can be used instead.
+
+To use Classy as your base theme, set the 'base theme' in your theme's .info.yml
+file to "classy":
+  base theme: classy
+
+See https://www.drupal.org/theme-guide/8/classy for more information on using
+the Classy theme.
+
+ABOUT DRUPAL THEMING
+--------------------
+
+See https://www.drupal.org/theme-guide/8 for more information on Drupal theming.