feat: complete terminal docs

Author: devvaannsh

docs/08-Features/12-terminal.md

@@ -2,54 +2,54 @@
 title: Terminal
 ---
 
+import React from 'react';
+import VideoPlayer from '@site/src/components/Video/player';
+
 Phoenix Code has a built-in terminal so you can run commands without leaving the editor.
 
 > The terminal is available only in desktop apps.
 
-<!-- Add an image here showing the terminal panel with a couple of tabs and a running command -->
+<!-- Add a workflow video here showing: opening the panel, running a command, multiple tabs, switching shells, closing -->
 
 ## Opening the Terminal
 
-There are a few ways to open the terminal:
+Open the terminal in any of these ways:
 
 - Click the **Tools** button *(grid icon)* in the bottom-right toolbar and select **Terminal**
 - Go to **View > Terminal** from the menu bar
 - Press `F4`
+- Right-click a file or folder in the project tree and choose **Integrated Terminal**. The terminal opens at that folder (or the file's containing folder)
+
+<!-- Add an image of the project tree right-click menu showing the Integrated Terminal item -->
 
 ## Tabs
 
 You can have multiple terminals open at the same time, each in its own tab. The tab sidebar shows the running process name for each terminal.
 
 To create a new tab, click the **+** button at the bottom of the tab sidebar.
 
-To close a tab, hover over it and click the **X** button. If a process is still running, Phoenix Code asks for confirmation before closing.
+To close a single tab, hover over it and click the **X** button. To close every terminal at once, click the panel's X button. Phoenix Code asks for confirmation if any process is still running.
+
+When the terminal is focused and more than one tab is open, pressing `F4` cycles to the next tab.
 
-<!-- Add an image here showing the tab sidebar with multiple terminal tabs -->
+<!-- Add an image of the tab sidebar with multiple terminal tabs -->
 
 ## Shell Selection
 
-Click the **dropdown button** *(chevron icon)* next to the new tab button to pick a different shell. The available options depend on your operating system:
+Click the **dropdown button** *(chevron icon)* next to the new tab button to pick a different shell. The default options are:
 
 - **macOS**: zsh, bash, fish
 - **Linux**: bash, zsh, fish
 - **Windows**: PowerShell, Command Prompt, Git Bash, WSL
 
 Selecting a shell sets it as the default and opens a new terminal with it right away.
 
-> Only shells that are installed on your system are shown.
-
-## Right-Click Menu
-
-Right-click inside the terminal to access:
-
-- **Copy** - copy selected text
-- **Paste** - paste from clipboard
-- **Clear Terminal** - clear the terminal output
+> Only shells installed on your system are shown. Any other compatible shell on your system (for example, PowerShell Core on Windows) also appears in the list.
 
 ## Keyboard Shortcuts
 
 | Action | Shortcut |
 |--------|----------|
-| Toggle terminal | `F4` |
+| Toggle terminal / cycle to next instance (when more than one is open) | `F4` |
 | Switch focus between editor and terminal | `Shift + Escape` |
 | Clear terminal buffer | `Ctrl/Cmd + K` |