Fixed review comments on documentation

Author: anilsahoo20

docs/en_US/auto_update_desktop_app.rst

@@ -0,0 +1,96 @@
+Auto-Update of pgAdmin 4 Desktop Application
+********************************************
+
+pgAdmin 4's desktop application includes an automated update system built using 
+Electron's ``autoUpdater`` module. This feature enables users to receive and install 
+updates seamlessly, ensuring they always have access to the latest features and security fixes.
+
+Supported Platforms
+===================
+
+- **macOS:** Fully supported with automatic updates enabled by default
+- **Windows:** Not supported
+- **Linux:** Not supported
+
+Update Process Overview
+=======================
+
+1. **Check for Updates:**
+   
+   - Automatic check on application startup
+   - Manual check available via pgAdmin 4 menu > Check for Updates
+   - Uses Electron's ``autoUpdater`` API to query update server
+
+2. **Download Process:**
+   
+   - Updates download automatically when detected
+   - Progress shown via notifications
+   - Background download prevents interruption of work
+
+3. **Installation Flow:**
+   
+   - User prompted to Install & Restart or Restart Later when update ready
+   - Update applied during application restart
+
+  The flow chart for the update process is as follows:
+
+  .. image:: images/auto_update_desktop_app.png
+    :alt: Auto-update Desktop App
+    :align: center
+
+User Interface Components
+=========================
+
+1. **Notification Types:**
+   
+   - Update available
+   - Download progress
+   - Update ready to install
+   - Error notifications
+
+2. **Menu Integration:**
+   
+   - Check for Updates option in pgAdmin 4 menu
+   - Restart to Update option when  update available
+
+Error Handling
+==============
+
+The system includes comprehensive error handling:
+
+1. **Network Errors:**
+   
+   - Connection timeouts
+   - Download failures
+   - Server unavailability
+
+2. **Installation Errors:**
+   
+   - Corrupted downloads
+
+3. **Recovery Mechanisms:**
+   
+   - Fallback to manual update
+   - Error reporting to logs
+
+Security Considerations
+=======================
+
+The update system implements below security measures:
+
+1. **Secure Communication:**
+
+   - Protected update metadata
+
+Platform-Specific Notes
+=======================
+
+1. **macOS:**
+   
+   - Uses native update mechanisms
+   - Requires signed packages
+
+References
+==========
+
+- `Electron autoUpdater API Documentation <https://www.electronjs.org/docs/latest/api/auto-updater>`_

docs/en_US/desktop_deployment.rst

@@ -129,155 +129,9 @@ will be available on Unix systems (~/.local/share/pgadmin/),
 on Mac OS X (~/Library/Preferences/pgadmin),
 and on Windows (%APPDATA%/pgadmin).
 
+For details on the auto-update system for the desktop application, see
 
-Auto-Update of pgAdmin 4 Desktop Application
-********************************************
+.. toctree::
+   :maxdepth: 1
 
-pgAdmin 4's desktop application includes an automated update system built using 
-Electron's ``autoUpdater`` module. This feature enables users to receive and install 
-updates seamlessly, ensuring they always have access to the latest features and security fixes.
-
-Supported Platforms
-===================
-
-- **macOS:** Fully supported with automatic updates enabled by default
-- **Windows:** Not supported
-- **Linux:** Not supported
-
-Update Process Overview
-=======================
-
-1. **Check for Updates:**
-   
-   - Automatic check on application startup
-   - Manual check available via pgAdmin 4 menu > Check for Updates
-   - Uses Electron's ``autoUpdater`` API to query update server
-
-2. **Download Process:**
-   
-   - Updates download automatically when detected
-   - Progress shown via notifications
-   - Background download prevents interruption of work
-
-3. **Installation Flow:**
-   
-   - User prompted to Install & Restart or Restart Later when update ready
-   - Update applied during application restart
-
-  The flow chart for the update process is as follows:
-
-  .. image:: images/auto_update_desktop_app.png
-    :alt: Runtime View Log
-    :align: center
-
-Technical Architecture
-======================
-
-1. **Main Process**
-
-   Handles core update functionality:
-
-   File: runtime/src/js/autoUpdaterHandler.js
-
-   .. code-block:: javascript
-
-      autoUpdater.on('checking-for-update', () => {
-         misc.writeServerLog('[Auto-Updater]: Checking for update...');
-      });
-
-      autoUpdater.on('update-available', () => {
-         setConfigAndRefreshMenu('update-available');
-         misc.writeServerLog('[Auto-Updater]: Update downloading...');
-         pgAdminMainScreen.webContents.send('notifyAppAutoUpdate', {update_downloading: true});
-      });
-
-2. **Renderer Process**
-
-   Manages user interface updates:
-
-   File: web/pgadmin/static/js/BrowserComponent.jsx
-
-   .. code-block:: javascript
-
-      if (window.electronUI && typeof window.electronUI.notifyAppAutoUpdate === 'function') {
-         window.electronUI.notifyAppAutoUpdate((data)=>{
-            if (data?.check_version_update) {
-               pgAdmin.Browser.check_version_update(true);
-            } else if (data.update_downloading) {
-               appAutoUpdateNotifier('Update downloading...', 'info', null, 10000);
-            } else if (data.no_update_available) {
-               appAutoUpdateNotifier('No update available...', 'info', null, 10000);
-            } else if (data.update_downloaded) {
-               const UPDATE_DOWNLOADED_MESSAGE = gettext('An update is ready. Restart the app now to install it, or later to keep using the current version.');
-               appAutoUpdateNotifier(UPDATE_DOWNLOADED_MESSAGE, 'warning', installUpdate, null, 'Update downloaded', 'update_downloaded');
-            } else if (data.error) {
-               appAutoUpdateNotifier(`${data.errMsg}`, 'error');
-            } else if (data.update_installed) {
-               const UPDATE_INSTALLED_MESSAGE = gettext('Update installed successfully!');
-               appAutoUpdateNotifier(UPDATE_INSTALLED_MESSAGE, 'success');
-            }
-         });
-      }
-
-3. **Update Server Communication**
-
-   - Configures update feed URL based on version information
-   - Handles server response validation
-   - Manages error conditions
-
-User Interface Components
-=========================
-
-1. **Notification Types:**
-   
-   - Update available
-   - Download progress
-   - Update ready to install
-   - Error notifications
-
-2. **Menu Integration:**
-   
-   - Check for Updates option in pgAdmin 4 menu
-   - Restart to Update option when  update available
-
-Error Handling
-==============
-
-The system includes comprehensive error handling:
-
-1. **Network Errors:**
-   
-   - Connection timeouts
-   - Download failures
-   - Server unavailability
-
-2. **Installation Errors:**
-   
-   - Corrupted downloads
-
-3. **Recovery Mechanisms:**
-   
-   - Fallback to manual update
-   - Error reporting to logs
-
-Security Considerations
-=======================
-
-The update system implements below security measures:
-
-1. **Secure Communication:**
-
-   - Protected update metadata
-
-Platform-Specific Notes
-=======================
-
-1. **macOS:**
-   
-   - Uses native update mechanisms
-   - Requires signed packages
-
-References
-==========
-
-- `Electron autoUpdater API Documentation <https://www.electronjs.org/docs/latest/api/auto-updater>`_
+   auto_update_desktop_app