[cuegui] Add descriptive labels to Monitor Jobs action buttons (#1846)

[cuegui] Add descriptive labels to Monitor Jobs action buttons
- Add clear text labels to all action buttons for better discoverability
- Update tooltips to explain each action's purpose
- Buttons now display: "Eat Dead Frames", "Retry Dead Frames", "Kill
Jobs", "Pause Jobs", "Unpause Jobs"
- Improves UI accessibility and reduces user confusion about button
functions
- [docs] Update documentation for Monitor Jobs descriptive button labels
- Update cuetopia-monitoring-guide.md with new button labels and
descriptions
   - Update CueGUI-app.md reference to reflect new toolbar button labels
- Document button functionality: "Eat Dead Frames", "Retry Dead Frames",
"Kill Jobs", "Pause Jobs", "Unpause Jobs"
   - Clarify button tooltips and their purposes in the documentation
   - Update CueGUI images in the documentation

**Link the Issue(s) this Pull Request is related to.**
- #1845

Author: ramonfigueiredo

cuegui/cuegui/plugins/MonitorJobsPlugin.py

@@ -294,38 +294,35 @@ def handleUnmonitorSelection(index):
         unmonitorCombo.currentIndexChanged.connect(handleUnmonitorSelection)
         layout.addWidget(unmonitorCombo)
 
-        eatSelectedButton = QtWidgets.QPushButton(QtGui.QIcon(":eat.png"), "")
-        eatSelectedButton.setToolTip("Eats all dead frames for selected jobs")
+        eatSelectedButton = QtWidgets.QPushButton(QtGui.QIcon(":eat.png"), "Eat Dead Frames")
+        eatSelectedButton.setToolTip(
+            "Eats all dead frames for selected jobs to free scheduling resources")
         eatSelectedButton.setFocusPolicy(QtCore.Qt.NoFocus)
-        eatSelectedButton.setFlat(True)
         layout.addWidget(eatSelectedButton)
-        eatSelectedButton.clicked.connect(self.jobMonitor.actionEatSelectedItems)  # pylint: disable=no-member
+        eatSelectedButton.clicked.connect(
+            self.jobMonitor.actionEatSelectedItems)  # pylint: disable=no-member
 
-        retryButton = QtWidgets.QPushButton(QtGui.QIcon(":retry.png"), "")
+        retryButton = QtWidgets.QPushButton(QtGui.QIcon(":retry.png"), "Retry Dead Frames")
         retryButton.setToolTip("Retries all dead frames for selected jobs")
         retryButton.setFocusPolicy(QtCore.Qt.NoFocus)
-        retryButton.setFlat(True)
         layout.addWidget(retryButton)
         retryButton.clicked.connect(self.jobMonitor.actionRetrySelectedItems)  # pylint: disable=no-member
 
-        killButton = QtWidgets.QPushButton(QtGui.QIcon(":kill.png"), "")
-        killButton.setToolTip("Kill selected jobs")
+        killButton = QtWidgets.QPushButton(QtGui.QIcon(":kill.png"), "Kill Jobs")
+        killButton.setToolTip("Kill selected jobs and their running frames")
         killButton.setFocusPolicy(QtCore.Qt.NoFocus)
-        killButton.setFlat(True)
         layout.addWidget(killButton)
         killButton.clicked.connect(self.jobMonitor.actionKillSelectedItems)  # pylint: disable=no-member
 
-        pauseButton = QtWidgets.QPushButton(QtGui.QIcon(":pause.png"), "")
-        pauseButton.setToolTip("Pause selected jobs")
+        pauseButton = QtWidgets.QPushButton(QtGui.QIcon(":pause.png"), "Pause Jobs")
+        pauseButton.setToolTip("Pause selected job")
         pauseButton.setFocusPolicy(QtCore.Qt.NoFocus)
-        pauseButton.setFlat(True)
         layout.addWidget(pauseButton)
         pauseButton.clicked.connect(self.jobMonitor.actionPauseSelectedItems)  # pylint: disable=no-member
 
-        unpauseButton = QtWidgets.QPushButton(QtGui.QIcon(":unpause.png"), "")
+        unpauseButton = QtWidgets.QPushButton(QtGui.QIcon(":unpause.png"), "Unpause Jobs")
         unpauseButton.setToolTip("Unpause selected jobs")
         unpauseButton.setFocusPolicy(QtCore.Qt.NoFocus)
-        unpauseButton.setFlat(True)
         layout.addWidget(unpauseButton)
         unpauseButton.clicked.connect(self.jobMonitor.actionResumeSelectedItems)  # pylint: disable=no-member
 

docs/_docs/reference/CueGUI-app.md

@@ -62,30 +62,36 @@ CueGUI provides convenient copy buttons to quickly copy job, layer, and frame na
 
 To copy a job name to the clipboard, right-click on a job in the *Monitor Jobs* view and select **Copy Job Name**. The exact job name will be copied to your clipboard.
 
-![Copy Job Name context menu](/assets/images/cuegui/cuegui_copy_job_name.png)
+![Copy Job Name context menu](/assets/images/cuegui/cuetopia/cuegui_copy_job_name.png)
 
 ### Copying layer names
 
 To copy a layer name, right-click on a layer in the job details view and select **Copy Layer Name**. This copies the layer name to your clipboard.
 
-![Copy Layer Name context menu](/assets/images/cuegui/cuegui_copy_layer_name.png)
+![Copy Layer Name context menu](/assets/images/cuegui/cuetopia/cuegui_copy_layer_name.png)
 
 ### Copying frame names
 
 To copy a frame name, right-click on a frame in the frame list and select **Copy Frame Name**. The frame name will be copied to your clipboard.
 
-![Copy Frame Name context menu](/assets/images/cuegui/cuegui_copy_frame_name.png)
+![Copy Frame Name context menu](/assets/images/cuegui/cuetopia/cuegui_copy_frame_name.png)
 
 All copy buttons use the same icon as the "Copy Log Path" feature for visual consistency. When multiple items are selected, all selected names will be copied to the clipboard separated by spaces.
 
-## Managing frames
+## Managing frames and jobs
 
-To manage frames, select one of the following:
+The Monitor Jobs toolbar provides action buttons for managing jobs and frames:
 
-*   **Retry** - Retrying a frame stops rendering and retries the frame on
-    another proc.
-*   **Eat** - Eating a frame stops rendering and doesn't try to continue
-    processing the frame.
+*   **Eat Dead Frames** - Eats all dead frames for selected jobs to free scheduling resources. Eating a frame stops rendering and marks it as complete without retrying.
+*   **Retry Dead Frames** - Retries all dead frames for selected jobs. Retrying requeues failed frames to run again.
+*   **Kill Jobs** - Kill selected jobs and their running frames. Stops all processing for the selected jobs.
+*   **Pause Jobs** - Pause selected job. No new frames will start on paused jobs.
+*   **Unpause Jobs** - Unpause selected jobs. Resumes processing of paused jobs.
+
+Individual frame management options are also available through right-click context menus:
+
+*   **Retry** - Retrying a frame stops rendering and retries the frame on another proc.
+*   **Eat** - Eating a frame stops rendering and doesn't try to continue processing the frame.
 *   **Kill** - Killing a frame stops rendering and books to another proc.
 
 ## Rendering and staggering frames

docs/_docs/user-guides/cuetopia-monitoring-guide.md

@@ -69,11 +69,11 @@ The toolbar contains the following controls from left to right:
    - **Selected Jobs**: Removes selected jobs
 
 8. **Action Buttons** (from left to right):
-   - **Eat** (pac-man icon): Eats all dead frames in selected jobs
-   - **Retry** (circular arrow): Retries all dead frames in selected jobs
-   - **Kill** (X icon): Kills selected jobs
-   - **Pause** (pause icon): Pauses selected jobs
-   - **Unpause** (play icon): Resumes selected paused jobs
+   - **Eat Dead Frames** (pac-man icon): Eats all dead frames for selected jobs to free scheduling resources
+   - **Retry Dead Frames** (circular arrow): Retries all dead frames for selected jobs
+   - **Kill Jobs** (X icon): Kill selected jobs and their running frames
+   - **Pause Jobs** (pause icon): Pause selected job
+   - **Unpause Jobs** (play icon): Unpause selected jobs
 
 ### Job Table Columns
 
@@ -141,7 +141,7 @@ Right-clicking on a job provides these actions:
 
 The Monitor Job Details plugin provides detailed information about a selected job's layers and frames. It can be opened manually from the menu or appears automatically when you double-click a job in the Monitor Jobs view.
 
-![Job Details Interface](/assets/images/cuegui/cuetopia_monitor_jobs_details.png)
+![Job Details Interface](/assets/images/cuegui/cuetopia/cuetopia_monitor_jobs_details.png)
 
 ### Layout Structure
 
@@ -232,7 +232,7 @@ Frames are color-coded by status:
 
 The Job Graph plugin provides a visual node-based representation of job layers and their dependencies.
 
-![Job Graph Interface](/assets/images/cuegui/cuetopia_job_graph.png)
+![Job Graph Interface](/assets/images/cuegui/cuetopia/cuetopia_job_graph.png)
 
 ### Graph Features
 

docs/_docs/user-guides/monitoring-jobs.md

@@ -157,7 +157,7 @@ The OS filter allows you to filter hosts based on their operating system:
 4. The host list updates to show only hosts matching the selected OS values
 5. Use the **Clear** option to remove all OS filters
 
-![Monitor Hosts with OS Filter](/assets/images/cuegui/cuecommander_monitor_os_filter.png)
+![Monitor Hosts with OS Filter](/assets/images/cuegui/cuecommander/cuecommander_monitor_os_filter.png)
 
 The OS filter list dynamically updates based on the operating systems detected in your host environment. When you first open CueCommander, the filter displays "Not Loaded" to indicate that host data hasn't been retrieved yet. Once hosts are loaded, the filter automatically populates with the actual OS values found in your system.