diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/be-toc.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/be-toc.vm
index bb0d01f416fbea..75a7bb2723ee44 100644
--- a/src/main/java/com/google/devtools/build/docgen/templates/be/be-toc.vm
+++ b/src/main/java/com/google/devtools/build/docgen/templates/be/be-toc.vm
@@ -9,7 +9,15 @@ toc:
     path: /reference/be/make-variables
   - title: Functions
     path: /reference/be/functions
-  - title: Language-specific rules
+  - title: Core rules
+    section:
+#foreach ($ruleFamily in $genericRuleFamilies)
+#if ($ruleFamily.size() > 0)
+    - title: ${ruleFamily.name}
+      path: /reference/be/${ruleFamily.id}
+#end
+#end
+  - title: Language Specific rules
     section:
 #foreach ($ruleFamily in $langSpecificRuleFamilies)
 #if ($ruleFamily.size() > 0)
@@ -53,11 +61,3 @@ toc:
     - title: Scala
       path: https://github.com/bazelbuild/rules_scala
       status: external
-  - title: Language-agnostic rules
-    section:
-#foreach ($ruleFamily in $genericRuleFamilies)
-#if ($ruleFamily.size() > 0)
-    - title: ${ruleFamily.name}
-      path: /reference/be/${ruleFamily.id}
-#end
-#end
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm
index d767dcd0388c77..a85a5d367b1fb3 100644
--- a/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm
+++ b/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm
@@ -19,6 +19,12 @@
 
 ${ruleFamily.summary}
 
+<h2>Context</h2>
+This set of rules exist to help model specific hardware platforms you are
+building for and the tools you may use to compile code for those platforms.
+The user should be familiar with the concepts explained
+<a href="//extending/platforms">here</a>.
+
 #if (!$singlePage)
 <h2>Rules</h2>
 <ul>
diff --git a/src/main/java/com/google/devtools/build/lib/rules/ToolchainType.java b/src/main/java/com/google/devtools/build/lib/rules/ToolchainType.java
index 2d682eacfd8c59..194973e6c60873 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/ToolchainType.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/ToolchainType.java
@@ -71,7 +71,7 @@ public Metadata getMetadata() {
     }
   }
 }
-/*<!-- #BLAZE_RULE (NAME = toolchain_type, FAMILY = Platform)[GENERIC_RULE] -->
+/*<!-- #BLAZE_RULE (NAME = toolchain_type, FAMILY = Platforms and Toolchains)[GENERIC_RULE] -->
 
 <p>
   This rule defines a new type of toolchain -- a simple target that represents a class of tools that
diff --git a/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintSettingRule.java b/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintSettingRule.java
index 29f3ad55bdfdcd..0f319707998b39 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintSettingRule.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintSettingRule.java
@@ -77,7 +77,7 @@ public RuleDefinition.Metadata getMetadata() {
         .build();
   }
 }
-/*<!-- #BLAZE_RULE (NAME = constraint_setting, FAMILY = Platform)[GENERIC_RULE] -->
+/*<!-- #BLAZE_RULE (NAME = constraint_setting, FAMILY = Platforms and Toolchains)[GENERIC_RULE] -->
 
 <p>This rule is used to introduce a new constraint type for which a platform may specify a value.
 For instance, you might define a <code>constraint_setting</code> named "glibc_version" to represent
diff --git a/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintValueRule.java b/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintValueRule.java
index 1f90585bc79833..7b1282874c8f7c 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintValueRule.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/platform/ConstraintValueRule.java
@@ -75,7 +75,7 @@ public Metadata getMetadata() {
         .build();
   }
 }
-/*<!-- #BLAZE_RULE (NAME = constraint_value, FAMILY = Platform)[GENERIC_RULE] -->
+/*<!-- #BLAZE_RULE (NAME = constraint_value, FAMILY = Platforms and Toolchains)[GENERIC_RULE] -->
 
 This rule introduces a new value for a given constraint type.
 
diff --git a/src/main/java/com/google/devtools/build/lib/rules/platform/PlatformRule.java b/src/main/java/com/google/devtools/build/lib/rules/platform/PlatformRule.java
index ef76c2dc4b74f0..13cf9675795557 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/platform/PlatformRule.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/platform/PlatformRule.java
@@ -135,7 +135,7 @@ public Metadata getMetadata() {
         .build();
   }
 }
-/*<!-- #BLAZE_RULE (NAME = platform, FAMILY = Platform)[GENERIC_RULE] -->
+/*<!-- #BLAZE_RULE (NAME = platform, FAMILY = Platforms and Toolchains)[GENERIC_RULE] -->
 
 <p>This rule defines a new platform -- a named collection of constraint choices
 (such as cpu architecture or compiler version) describing an environment in
diff --git a/src/main/java/com/google/devtools/build/lib/rules/platform/ToolchainRule.java b/src/main/java/com/google/devtools/build/lib/rules/platform/ToolchainRule.java
index 8db017b2fe20d6..5368eec961af35 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/platform/ToolchainRule.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/platform/ToolchainRule.java
@@ -107,7 +107,7 @@ public RuleDefinition.Metadata getMetadata() {
         .build();
   }
 }
-/*<!-- #BLAZE_RULE (NAME = toolchain, FAMILY = Platform)[GENERIC_RULE] -->
+/*<!-- #BLAZE_RULE (NAME = toolchain, FAMILY = Platforms and Toolchains)[GENERIC_RULE] -->
 
 <p>This rule declares a specific toolchain's type and constraints so that it can be selected
 during toolchain resolution. See the