Merge pull request #349 from NationalSecurityAgency/t#347/various_4_4_updates

T#347/various 4 4 updates

Author: dwalizer

docs/dashboard/user-guide/self-reporting.md

@@ -97,6 +97,18 @@ The approval queue can be filtered by:
 - **Skill Name** - Search for specific skills
 - **User ID** - Filter by specific users
 
+::: note
+Once at least one explicit workload handler is configured via
+the [Split Approval Workload](/dashboard/user-guide/self-reporting.html#split-approval-workload) configuration,
+administrators will see an additional `Assigned Approvers` column in the Approval Queue. This column displays the
+specific administrators or approvers assigned to handle each request.
+
+Additionally, a "My Requests Only" toggle allows administrators to filter the table to show only their assigned
+requests. Activating this toggle temporarily hides the `Assigned Approvers` column. The toggle state is saved in the
+browser's local storage, ensuring it persists across page refreshes.
+:::
+
+
 ### Approval History 
 
 Project administrators can can either approve or reject points/skill requests. 
@@ -207,6 +219,15 @@ Configuring explicit fallback users will then prevent requests from being forwar
 A very simple example is utilizing this feature to configure all the requests to go to a specific
 Approver only, as depicted in the screenshot above. 
 
+::: note
+Once at least one workload handler is configured, administrators will see an additional `Assigned Approvers` column in
+the [Approval Queue table](/dashboard/user-guide/self-reporting.html#approval-queue). This column displays the specific
+administrators or approvers assigned to handle each request.
+
+Additionally, a "My Requests Only" toggle allows administrators to filter the table to show only their assigned
+requests. Activating this toggle temporarily hides the `Assigned Approvers` column. The toggle state is saved in the
+browser's local storage, ensuring it persists across page refreshes.
+:::
 
 
 

docs/dashboard/user-guide/skills-groups.md

@@ -12,6 +12,11 @@ If let's say a group has ``5`` skills, you can configure it to only require ``3`
 In this case, when any of the ``3`` skills under that group are completed then the group achievement is awarded!
 :::
 
+::: note Dedicated Skill Group Page
+Skill Groups now have a dedicated page that provides a focused view for managing the group and its skills. 
+You can navigate to a Skill Group page by selecting ``Project -> Subject -> Group``.
+:::
+
 ![Skills Group Screenshot](../../screenshots/admin/page-skills-group.png)
 
 To create a group, navigate to ``Project -> Subject`` then click on ``Group +``, the following group properties can be specified:
@@ -41,3 +46,12 @@ Once at least 1 skill is added the group will be rendered in the Skills Display.
 Groups have an option to only require ``N`` skills out of the total available number of skills added to the group.
 For example, if a group has ``5`` skills, you can configure it to only require the completion of ``3`` skills.
 In this case, when any ``3`` skills under that group are completed then the group achievement is awarded!
+
+## Moving Groups
+
+Moving a group enables project administrators to transfer an entire Skill Group and all of its associated skills to a
+different subject.
+
+To move a group, navigate to the subject page (`Project -> Subject`), select one or more groups from the table using the
+checkboxes, and click the `Actions` button, followed by the `Move` option. A move modal will appear to guide you through
+selecting the destination and initiating the transfer.

docs/dashboard/user-guide/skills.md

@@ -238,18 +238,19 @@ Limitations:
   1. delete the skill using the dashboard
 - Edits to skills are not versioned and will be immediately visible to any display with this or earlier versions. This is mostly likely the behavior you want as any edit to a skill is a fix or an improvement.
 - Versioning is only applicable to new skills and doesn't apply to operations done on subjects, badges or other items within the gamificiation framework.  
-  
-     
-## Manually Add Skill Event
-There maybe a special situation when you want to give a user credit explicitly. Project admins can add Skill Events manually through the Dashboard:
-1. Locate the Subject that contains the Skill for which you would like to add an event
-1. Select ```Manage``` for the located Subject
-1. Locate the Skill and select ```Manage```
-    * The ```Filter``` box on the top left of the Skills table can be used to quickly locate a particular Skill
-1. Select ```Add Event``` from the Navigation menu on the left
-1. Enter the ```User Id``` of the user for whom the Skill Event will be added (note that the field supports type-ahead to locate existing users)
-1. Enter a date on which the Skill Event occurred (this will default to today's date)
-1. Select ```Add```
+
+
+## Manually Report Skills
+
+There may be special situations where you need to credit users explicitly. As a project administrator, you can manually
+report skill events across multiple skills for multiple users simultaneously. You can also specify the date against
+which those events are reported.
+
+To manually report skills:
+1. Navigate to the subject page (`Project -> Subject`).
+2. Select one or more skills from the table using the checkboxes.
+3. Click the `Actions` button, then select the `Report Skills for Users` option.
+4. Follow the step-by-step guidance in the skill reporting modal to complete the process.
 
 ## Incremental Changes
 This section explain how various scenarios are handled when skills are modified/removed/added 
@@ -353,10 +354,19 @@ to learn more please visit the [Self Reporting](/dashboard/user-guide/self-repor
 - Reused skills cannot be added to a badge; use the original skill instead
 - Removing the original skill will also delete all of its reused copies
 
-## Move Skills
-Move Skills is a feature that allows project administrators to move skills to other subjects or skill groups within the same project.
-When skills are moved, users' points are preserved for those skills and level-based achievements are 
-properly re-calculated for both origination and destination subject/group.
+## Moving Skills
+
+Moving Skills allows project administrators to move skills within the same project.
+
+Skills can be moved to:
+
+- another subject
+- another skill group
+
+When skills are moved:
+
+- users keep their points for the moved skills
+- level-based achievements are recalculated for both the source and destination subject or group
 
 ::: tip
 The ability to move skills between subjects gives project administrators gives project administrators the ability to refine their training profile after the initial creation of skills.
@@ -371,6 +381,12 @@ on the Action button located on the top-right above the skills' table. Select th
 All the skills under a subject or group can be easily selected via the ``Select All`` button
 :::
 
+::: note
+You can also move one or more Skill Groups. Please visit
+the [Moving Groups Section](/dashboard/user-guide/skills-groups.html#moving-groups) to learn more.
+:::
+
+
 ## Skill Tags
 
 Skill tagging is a feature that allows administrators to add one or more custom "tags" to skills.

docs/release-notes/skills-service.md

@@ -13,13 +13,13 @@ To obtain deployable artifacts please visit [Distributions](/dashboard/install-g
 - Skill Group Enhancements
   * **Dedicated Management Page**: Created a centralized administrative view to define and manage Skill Groups and their associated skills.
   * **Progress Visualization**: Added a dedicated dashboard tracking overall user progress within a specific Skill Group.
-  * **Group Migration**: Enabled administrators to move an entire Skill Group and its skills to a different subject within the same project.
-  * **Expanded Metrics**: Integrated Skill Group data directly into the metrics achievement table.
-  * **Trainee View**: Launched a new trainee-facing Skill Group page for users to track their own skills and progress.
-  * **Search Integration**: Added Skill Groups to the skills search interface with support for direct navigation.
+  * **Group Migration**: Enabled administrators to [move an entire Skill Group](/dashboard/user-guide/skills-groups.html#moving-groups) and its skills to a different subject within the same project.
+  * **Expanded Metrics**: Integrated Skill Group data directly into the [metrics achievement table](/dashboard/user-guide/metrics.html#project-achievements-metrics).
+  * **Trainee View**: Launched a new trainee-facing [Skill Group](/training-participation/take-training.html#skill-groups) page for users to track their own skills and progress.
+  * **Search Integration**: Added Skill Groups to the [skills search interface](/training-participation/take-training.html#training-wide-search) with support for direct navigation.
 - Administrative Workflows
-  * **Bulk Skill Reporting**: Added an administrative function to manually report multiple skills for multiple users simultaneously.
-  * **Enhanced Request Tracking**: Upgraded the self-report approval requests table to display all active requests alongside their assigned approvers.
+  * **[Bulk Skill Reporting](/dashboard/user-guide/skills.html#manually-report-skills)**: Added an administrative function to manually report multiple skills for multiple users simultaneously.
+  * **Enhanced Request Tracking**: Upgraded the [self-report approval requests table](/dashboard/user-guide/self-reporting.html#approval-queue) to display all active requests alongside their assigned approvers.
 - Resolved various stability and performance issues to improve platform reliability.
 
 

docs/screenshots/admin/page-project-metrics-achievements.png

@@ -104,6 +104,11 @@ storage, so your preferences are maintained between sessions.
 Use the expand/collapse all groups controls at the top of the skill list to manage multiple groups at once.
 :::
 
+::: note
+You can click on any Skill Group title to navigate to its dedicated page and view its details and skills.
+:::
+
+
 ## Badge Page
 
 To access a Badge page, click the **View** button inside the **My Badges** card and then click on the **View** button for a specific badge.
@@ -348,8 +353,8 @@ You can always review your survey completions on the [Quizzes and Surveys Histor
 
 ## Training Wide Search
 
-Training-wide search functionality enables users to quickly find and navigate to any skill, subject, or badge by name.
-This is an effective method to jump directly to any skill, subject, or badge from any page of the training.
+Training-wide search functionality enables users to quickly find and navigate to any skill, group, subject, or badge by name.
+This is an effective method to jump directly to any skill, group, subject, or badge from any page of the training.
 
 The search can be activated either through a dedicated search button in the top right corner of the training or by using customizable keyboard shortcuts.
 - To initiate the search via the search button, click the **Search** button in the top right corner of the training page.
@@ -360,9 +365,9 @@ Once the search is initiated, the search modal will appear in the middle of the
 ![component-training-wide-search.png](../screenshots/progress-and-ranking/component-training-wide-search.png)
 
 To use the search:
-- Type the name of the skill, subject, or badge you are searching for into the search box.
+- Type the name of the skill, group, subject, or badge you are searching for into the search box.
 - Use the up and down arrow keys to navigate through the search results.
-- Press **Enter** to select a skill, subject, or badge.
+- Press **Enter** to select and navigate directly to a skill, group, subject, or badge page.
 - Press **Escape** to close the search modal.
 
 ::: tip Shortcut Customization