From ecafbcf5e31408bc8855fd503f59e223eb49180f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9s?= <andres.maneiro@automattic.com>
Date: Fri, 29 May 2020 18:14:29 +0200
Subject: [PATCH] Document core/heading/*

---
 .../developers/themes/theme-json.md           | 47 ++++++++++++++++++-
 1 file changed, 45 insertions(+), 2 deletions(-)

diff --git a/docs/designers-developers/developers/themes/theme-json.md b/docs/designers-developers/developers/themes/theme-json.md
index 82fe0313fcf64..c7832103c24eb 100644
--- a/docs/designers-developers/developers/themes/theme-json.md
+++ b/docs/designers-developers/developers/themes/theme-json.md
@@ -157,6 +157,8 @@ The list of properties that are currently exposed via this method are:
 - Paragraph and Heading: line-height, font-size, color, background-color.
 - Group, Columns, and MediaText: color, background-color, background.
 
+Note that, the heading block, represents 6 distinct HTML elements: H1-H6. It comes with selectors to target individual elements (ex: core/heading/h1 for H1) as well a selector to target all of them (core/heading).
+
 ### Features
 
 This is being implemented, so it's not currently available.
@@ -201,8 +203,49 @@ This is being implemented, so it's not currently available.
       }
     }
   },
-  /* core/heading/h1, core/heading/h2, etc */
-  core/heading/h*: {
+  core/heading: {
+    styles: {
+        line-height: <value>,
+        font-size: <value>,
+        color: <value>,
+    }
+  },
+  core/heading/h1: {
+    styles: {
+        line-height: <value>,
+        font-size: <value>,
+        color: <value>,
+    }
+  },
+  core/heading/h2: {
+    styles: {
+        line-height: <value>,
+        font-size: <value>,
+        color: <value>,
+    }
+  },
+  core/heading/h3: {
+    styles: {
+        line-height: <value>,
+        font-size: <value>,
+        color: <value>,
+    }
+  },
+  core/heading/h4: {
+    styles: {
+        line-height: <value>,
+        font-size: <value>,
+        color: <value>,
+    }
+  },
+  core/heading/h5: {
+    styles: {
+        line-height: <value>,
+        font-size: <value>,
+        color: <value>,
+    }
+  },
+  core/heading/h6: {
     styles: {
       typography: {
         lineHeight: <value>,