From 1e04a5b33ed422884e94961d0dbbe73fc79fd3a8 Mon Sep 17 00:00:00 2001
From: Daniel Imms <2193314+Tyriar@users.noreply.github.com>
Date: Wed, 6 Sep 2023 12:15:46 -0700
Subject: [PATCH] Document hideOnStartup setting

Part of microsoft/vscode#39137
---
 docs/terminal/advanced.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/terminal/advanced.md b/docs/terminal/advanced.md
index 6bc3562a66..60a68a2c3d 100644
--- a/docs/terminal/advanced.md
+++ b/docs/terminal/advanced.md
@@ -24,6 +24,14 @@ Both of these persistent sessions can be disabled by setting `terminal.integrate
 
 Terminal tabs can be dragged and dropped between VS Code windows. This can also be done manually through the Command Palette and the **Terminal: Detach Session** and **Terminal: Attach to Session** commands.
 
+### Configure how the terminal behaves on start up
+
+When opening a window, if the terminal view is visible it will either reconnect to the terminal using persistent sessions, or create a new shell. This behavior can be fine tuned with the `terminal.integrated.hideOnStartup` setting.
+
+* `never` (default): Never hide the terminal view on startup.
+* `whenEmpty`: Only hide the terminal when there are no persistent sessions restored.
+* `always`: Always hide the terminal, even when there are persistent sessions restored.
+
 ## Keybinding and the shell
 
 As an embedded application, the integrated terminal should intercept some, but not all, keybindings dispatched within VS Code.