#359 - documented new project level skill tag management and user

cypress/e2e/admin.cy.js

@@ -809,8 +809,6 @@ context('Admin: Generate Screenshots', () => {
       cy.get('[data-cy="saveDialogBtn"]').should('be.enabled')
       cy.get('[data-cy="saveDialogBtn"]').click();
 
-      cy.snap('page-skill-tags')
-
       cy.visit('/administrator/projects/movies/skill-tags/harrypottercollection');
       cy.get('[data-cy="noContent"]').contains('No Skills Added Yet...')
       cy.selectSkill('[data-cy="skillsSelector"]', 'HarryPotterandthePhilosophersStone');
@@ -824,6 +822,29 @@ context('Admin: Generate Screenshots', () => {
 
       cy.snap('page-skill-tag')
 
+      cy.visit('/administrator/projects/movies/skill-tags/despicablemecollection');
+      cy.get('[data-cy="noContent"]').contains('No Skills Added Yet...')
+      cy.selectSkill('[data-cy="skillsSelector"]', 'Minions');
+      cy.selectSkill('[data-cy="skillsSelector"]', 'DespicableMe');
+      cy.selectSkill('[data-cy="skillsSelector"]', 'DespicableMe2');
+      cy.selectSkill('[data-cy="skillsSelector"]', 'DespicableMe3');
+
+
+      cy.visit('/administrator/projects/movies/skill-tags/thetwilightcollection');
+      cy.get('[data-cy="noContent"]').contains('No Skills Added Yet...')
+      cy.selectSkill('[data-cy="skillsSelector"]', 'TheTwilightSagaEclipse');
+      cy.selectSkill('[data-cy="skillsSelector"]', 'Twilight');
+      cy.selectSkill('[data-cy="skillsSelector"]', 'TheTwilightSagaNewMoon');
+      cy.selectSkill('[data-cy="skillsSelector"]', 'TheTwilightSagaBreakingDawnPart2');
+
+      cy.visit('/administrator/projects/movies/skill-tags/harrypottercollection/users');
+      cy.wait(1000)
+      cy.snap('page-skill-tag-users')
+
+      cy.visit('/administrator/projects/movies/skill-tags/');
+      cy.wait(1000)
+      cy.snap('page-skill-tags')
+
       cy.deleteSkillTag('harrypottercollection')
       cy.deleteSkillTag('despicablemecollection')
       cy.deleteSkillTag('thetwilightcollection')

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

@@ -1,23 +1,71 @@
 # Skill Tags
 
-Skill tagging is a feature that allows administrators to add one or more custom "tags" to skills.
-Adding tags to skills can help to categorize and group skills, giving users another way to search or filter a particular set of skills.
-Skill tags are visualized in the Skills Display to give users consuming the training another way to comprehend, categorize and filter skills.
+Skill Tags allow project administrators to add one or more custom tags to skills. Tags provide an additional way to categorize, group, search, and filter skills across a project.
 
+Skill Tags are also displayed in the Skills Display so trainees can more easily understand how skills relate to one another, discover related training, and filter skills by tag.
 
-::: note Dedicated Skill Tags Page
-There is now a dedicated Skill Tags page that provides a focused view for managing all skill tags across your project. There is also a dedicated
-Single Skill Tag management page that enables administrators to manage tagged skills with the particular tag
+::: note Project-Level Skill Tag Management
+Skill Tags are now managed at the project level. Administrators can use the dedicated Skill Tags page to view and manage all tags across a project, drill into a single tag to manage its associated skills, and review trainee progress for skills associated with a specific tag.
 :::
 
 ## Skill Tags Management Page
 
 ![Skill Tags Management Page](../../screenshots/admin/page-skill-tags.png)
 
-To manage skill tags access your project, navigate to ``Project -> Skill Tags``.  From this page you can view all skill tags, create new skill tags and delete existing tags.
+To manage Skill Tags, open your project and navigate to `Project -> Skill Tags`.
+
+From the Skill Tags page, administrators can:
+
+- View all Skill Tags defined in the project
+- Create new Skill Tags
+- Delete existing Skill Tags
+- Open a dedicated management page for a specific tag
+- Review how many skills are associated with each tag
+
+This page provides a centralized place to manage tags across the entire project instead of managing them only from an individual subject or skill context.
 
 ## Single Skill Tag Management Page
 
-Clicking on a skill tag name from the Skill Tags management page will bring you to the Single Skill Tag management page, where you can choose which skill(s) should include this tag, as well as update the Tag Value and Tag ID.
 ![Single Skill Tag Management](../../screenshots/admin/page-skill-tag.png)
 
+Click a Skill Tag name from the Skill Tags management page to open the Single Skill Tag management page.
+
+From this page, administrators can:
+
+- Add skills to the selected tag
+- Remove skills from the selected tag
+- View all skills currently associated with the tag
+- Edit the tag value
+- Edit the tag ID
+- Review user progress for project participants advancing through skills associated with the tag
+
+The Single Skill Tag management page is useful when maintaining a curated group of related skills, such as skills that belong to a specific collection, topic, technology area, curriculum track, or learning objective.
+
+## Editing Tag Values and Tag IDs
+
+Administrators can update both the display value and the ID of a Skill Tag.
+
+- **Tag Value** is the human-readable label displayed to administrators and trainees.
+- **Tag ID** is the unique identifier used internally and in URLs.
+
+When editing a tag, choose a clear and stable value that describes the group of skills it represents. If the tag is already in use, consider whether changing the tag value or ID could affect administrator workflows or references to that tag.
+
+## Viewing Trainee Progress by Skill Tag
+
+Skill Tags include project participant progress information for the skills associated with a specific tag. This allows administrators to review how users are advancing within a tagged collection of skills.
+
+This can be helpful for tracking progress across a specific training area, such as:
+
+- A curriculum module
+- A certification topic
+- A feature-specific training path
+- A collection of related skills
+- A technology or competency area
+
+![Single Skill Tag Users](../../screenshots/admin/page-skill-tag-users.png)
+
+## Skill Tags in the Skills Display
+
+Skill Tags are visible to trainees in the Skills Display. This gives trainees another way to understand, categorize, and filter available training.
+
+Tags can help trainees quickly identify related skills and focus on a particular set of training objectives.