1 files changed, 11 insertions, 6 deletions

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 6bb4275267..20f97b9f86 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -9184,12 +9184,17 @@ Some notes from Cal:
                         The critical requirement is that the URIs in the
                         target repository configuration point to the
                         correct remote location for the feeds.
-                        This example uses a location outside of the build
-                        system's <filename>deploy</filename> directory.
-                        Realize that it is possible to run a web server
-                        that gets the databases from
-                        <filename>deploy</filename> directory where the image
-                        was built.
+                        <note><title>Tip</title>
+                            For development purposes, you can point the web
+                            server to the build system's
+                            <filename>deploy</filename> directory.
+                            However, for production use, it is better to copy
+                            the package directories to a location outside of
+                            the build area and use that location.
+                            Doing so avoids situations where the build system
+                            overwrites or changes the
+                            <filename>deploy</filename> directory.
+                        </note>
                     </para>
 
                     <para>