dev-manual/start.rst: mention that PERSISTENT_DIR should be shared too

In the "Development environment summary", we mention that the shared
state dir can be shared for developers, but PERSISTENT_DIR should be
shared as well, otherwise bugs described in [1] can happen.

[1]: https://bugzilla.yoctoproject.org/show_bug.cgi?id=15921

[YOCTO #15921]

(From yocto-docs rev: 60a08db99a0562a7ff0856da2287d5339d37d239)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit 3954eda78f22f205cbd31857f5b0992900fe7b02)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>

1 files changed, 5 insertions, 0 deletions

diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst
index 798bca76ef..edeee92719 100644
--- a/documentation/dev-manual/start.rst
+++ b/documentation/dev-manual/start.rst
@@ -228,6 +228,11 @@ particular working environment and set of practices.
        used by developers in the same organization and share the same
        source directories on their machines.
 
+       If the :term:`SSTATE_DIR` directory is shared for multiple developers,
+       and you are using a :ref:`overview-manual/concepts:Hash Equivalence`
+       server with :term:`BB_HASHSERVE`, the :term:`PERSISTENT_DIR` directory
+       (``${TOPDIR}/cache`` by default) should be shared too.
+
     -  Set up an Autobuilder and have it populate the sstate cache and
        source directories.