1 files changed, 7 insertions, 3 deletions

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 1f8dba4eb6..7e90eb8ef1 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2040,7 +2040,8 @@
                 </para>
 
                 <para>
-                    Because the OpenEmbedded build system uses "signatures",
+                    Because the OpenEmbedded build system uses
+                    "<ulink url='&YOCTO_DOCS_REF_URL;#checksums'>signatures</ulink>",
                     which are unique to a given build, the build system
                     knows when to rebuild packages.
                     All the inputs into a given task are represented by a
@@ -2128,7 +2129,7 @@
                 </para>
 
                 <note>
-                    The OpenEmbedded build system does not maintain
+                    <para>The OpenEmbedded build system does not maintain
                     <filename>PR</filename> information as part of the
                     shared state (sstate) packages.
                     If you maintain an sstate feed, its expected that either
@@ -2136,7 +2137,10 @@
                     feed use a shared PR Service, or you do not run a PR
                     Service on any of your building systems.
                     Having some systems use a PR Service while others do
-                    not leads to obvious problems.
+                    not leads to obvious problems.</para>
+                    <para>For more information on shared state, see the
+                    "<ulink url='&YOCTO_DOCS_REF_URL;#shared-state-cache'>Shared State Cache</ulink>"
+                    section in the Yocto Project Reference Manual.</para>
                 </note>
             </section>