From c18ab9ba92d760b051de4bb77261b5d637000172 Mon Sep 17 00:00:00 2001
From: Philip Durbin <philip_durbin@harvard.edu>
Date: Thu, 3 Aug 2023 16:15:48 -0400
Subject: [PATCH] explain need to build base image for new Payara #8305

---
 doc/sphinx-guides/source/container/dev-usage.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/sphinx-guides/source/container/dev-usage.rst b/doc/sphinx-guides/source/container/dev-usage.rst
index 3fbe55766d5..c20bba04af7 100644
--- a/doc/sphinx-guides/source/container/dev-usage.rst
+++ b/doc/sphinx-guides/source/container/dev-usage.rst
@@ -6,6 +6,8 @@ Please note! This Docker setup is not for production!
 .. contents:: |toctitle|
         :local:
 
+.. _container-dev-quickstart:
+
 Quickstart
 ----------
 
@@ -183,3 +185,8 @@ There are a lot of tutorials how to connect your IDE's debugger to a remote endp
 as the endpoint. Here are links to the most common IDEs docs on remote debugging:
 `Eclipse <https://help.eclipse.org/latest/topic/org.eclipse.jdt.doc.user/concepts/cremdbug.htm?cp=1_2_12>`_,
 `IntelliJ <https://www.jetbrains.com/help/idea/tutorial-remote-debug.html#debugger_rc>`_
+
+Building Your Own Base Image
+----------------------------
+
+If you find yourself tasked with upgrading Payara, you will need to create your own base image before running the :ref:`container-dev-quickstart`. For instructions, see :doc:`base-image`.