From 7431b4efdd6ef75cbb0e57e42e23f14e473ab13f Mon Sep 17 00:00:00 2001
From: James Cherti <60946298+jamescherti@users.noreply.github.com>
Date: Wed, 18 Feb 2026 10:18:52 -0500
Subject: [PATCH] Update README.md

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 1f13cd1..7232b85 100644
--- a/README.md
+++ b/README.md
@@ -2581,6 +2581,8 @@ Keep in mind that if you change the `minimal-emacs-user-directory`, *minimal-ema
 
 ### How to make *minimal-emacs.d* install packages in the early-init phase instead of the init phase?
 
+NOTE: Running package initialization and installation during the early-init phase is **NOT RECOMMENDED** because this stage occurs before the GUI system, windowing, and comprehensive error-handling buffers are fully initialized. When package-install or `package-refresh-contents` triggers a failure—such as a TLS handshake error or a lost network connection—Emacs cannot yet render a graphical window to display the backtrace or warning. This results in a "silent" hang or a crash that provides no visual feedback to the user, forcing a pivot to a terminal to inspect standard output. Furthermore, many packages expect a fully functional frame and loaded user environment to configure themselves correctly; forcing them to load during early-init bypasses the intentional separation designed to let you set up UI-independent variables before the package system and GUI logic complicate the startup sequence.
+
 To install and load packages during the early-init phase, add the following to `post-early-init.el`:
 
 ```elisp