diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index ca96b3b277..ea280cb305 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -1000,6 +1000,38 @@
PARALLEL_MAKE
variable.
+
+
+ Inheriting the icecc class changes all sstate
+ signatures.
+ Consequently, if a development team has a dedicated build system
+ that populates
+ STATE_MIRRORS
+ and they want to reuse sstate from
+ STATE_MIRRORS, then all developers and the
+ build system need to either inherit the icecc
+ class or nobody should.
+
+
+
+ At the distribution level, you can inherit the
+ icecc class to be sure that all builders start
+ with the same sstate signatures.
+ After inheriting the class, you can then disable the feature by setting
+ the
+ ICECC_DISABLED
+ variable to "1" as follows:
+
+ INHERIT_DISTRO += "icecc"
+ ICECC_DISABLED ??= "1"
+
+ This practice makes sure everyone is using the same signatures but also
+ requires individuals that do want to use Icecream to enable the feature
+ individually as follows in your local.conf file:
+
+ ICECC_DISABLED = ""
+
+