diff --git a/modules/ROOT/pages/bare-metal.adoc b/modules/ROOT/pages/bare-metal.adoc
index cb0bb455..db9cd33d 100644
--- a/modules/ROOT/pages/bare-metal.adoc
+++ b/modules/ROOT/pages/bare-metal.adoc
@@ -111,3 +111,8 @@ IPAPPEND 2
 == PXE rootfs image
 
 include::pxe-artifacts.adoc[]
+
+== Dealing with hetrogenous hardware and Ignition
+
+If you have bare metal servers with different types and/or number of hard drives, today you must create a separate customized Ignition config for each machine (or machine class).
+A good model is to have the common parts of the configuration factored out into a separate Ignition configuration which can be included (via HTTP or inline) in the per-machine-type custom config.