dev-manual, ref-manual: Cross-references between PR Service and cache

Fixes YOCTO #3684

These changes help tie in the relationship between how the OE
build system uses checksums and such and the PR Service that
can track revision.

(From yocto-docs rev: 39a3010a3bb4b2c1d37aef60984ac16e85b56aac)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 12 insertions, 0 deletions

diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml
index a9c31c8b6e..3393e15933 100644
--- a/documentation/ref-manual/technical-details.xml
+++ b/documentation/ref-manual/technical-details.xml
@@ -194,6 +194,18 @@
         install them if they are deemed to be valid.
     </para>
 
+    <note>
+        The OpenEmbedded build system does not maintain
+        <link linkend='var-PR'><filename>PR</filename></link> information
+        as part of the Shared State packages.
+        Consequently, considerations exist that affect maintaining shared
+        state feeds.
+        For information on how the OpenEmbedded works with packages and can
+        track incrementing <filename>PR</filename> information, see the
+        "<ulink url='&YOCTO_DOCS_DEV_URL;#incrementing-a-package-revision-number'>Incrementing a Package Revision Number</ulink>"
+        section.
+    </note>
+
     <para>
         The rest of this section goes into detail about the overall incremental build
         architecture, the checksums (signatures), shared state, and some tips and tricks.