diff --git a/docs/dashboard/install-guide/config.md b/docs/dashboard/install-guide/config.md index 181ec888..c3e9120a 100644 --- a/docs/dashboard/install-guide/config.md +++ b/docs/dashboard/install-guide/config.md @@ -536,6 +536,35 @@ prior giving access to that private project. skills.authorization.invite.validateEmail=true ``` +### Project Expiration + +SkillTree allows users to easily experiment with training profiles by creating new projects or copying existing ones. +Given this level of autonomy, organizations may see hundreds or even thousands of projects created. + +SkillTree provides a project expiration feature to automatically remove abandoned projects from the system. + +You can modify how the project expiration feature works by configuring the following properties: + +```properties +# Projects are considered for removal after this many days of inactivity +skills.config.expireUnusedProjectsOlderThan: 180 +# After projects are marked for removal, they will not be removed for this many days. +# Project admins are notified daily and given a chance to retain the project. +skills.config.expirationGracePeriod: 7 +# Project expiration schedule +skills.config.projectExpirationSchedule: "0 4 0 * * *" +``` + +If a project has not been used for `expireUnusedProjectsOlderThan` days, it is flagged for removal. +Activity includes editing project definitions on the administration panel or trainees reporting skills. + +Once a project is flagged for removal, project administrators are notified and can choose to retain the project. +Notifications are sent via email, so ensure you configure your [email settings](/dashboard/user-guide/settings.html#email-settings) accordingly. + +The dashboard user interface will also display a warning message on a flagged project, alongside a button to retain it. + +If an administrator does not retain the project within the `expirationGracePeriod` days, the project is permanently removed. + ### AI Assistant Configuration The AI Assistant enhances content creation by generating learning materials automatically. To enable this feature, configure the following settings: diff --git a/docs/dashboard/user-guide/skills.md b/docs/dashboard/user-guide/skills.md index 64e1add3..834a9185 100644 --- a/docs/dashboard/user-guide/skills.md +++ b/docs/dashboard/user-guide/skills.md @@ -329,23 +329,21 @@ If so, those users will *NOT* lose their current level (per our overall strategy ## Same Project Skill Reuse -In-Project Skill Reuse is a feature that facilitates the reuse of skills within the same project. -A skill can be easily reused within another Subject or Skill Group. -Reused skills are read-only copies and cannot be mutated. -As skill occurrences are reported to the original skill they are also automatically propagated to the reused skills. -Changes to the original skill (ex. description, occurrences) are automatically synchronized to all the reused skills as well. +In-Project Skill Reuse allows you to reuse skills within the same project. +A skill can be reused within another Subject or Skill Group. -To reuse a skill navigate to the Skills page (``Project -> Subject``), then select skills to reuse -and click on the ``Action`` button located on the top-right above the skills' table. -Select the ``Reuse in this Project`` button to initiate the process. +Key behavior of reused skills: +* They are read-only copies and cannot be edited. +* Skill actions reported to the original skill propagate to reused copies. +* Changes to the original skill (e.g., description, occurrences) synchronize automatically. -![Reuse skills](../../screenshots/admin/page-export-to-catalog.png) +To reuse a skill: +1. Navigate to the Skills page (**Project -> Subject**). +2. Select the skills you want to reuse. +3. Click the **Action** button above the skills table. +4. Select **Reuse in this Project** to initiate the process. -Once the skills are reused you will see a ``REUSED`` tag next to each skill. - -::: tip -All the skills under a subject or group can be easily selected for reuse via the ``Select All`` button -::: +Once skills are reused, a **REUSED** tag will appear next to each copy. ### Skill occurrences propagation Please note that when skill occurrences are reported for an original skill, @@ -378,37 +376,35 @@ to learn more please visit the [Self Reporting](/dashboard/user-guide/self-repor ## Moving Skills -Moving Skills allows project administrators to move skills within the same project. +Moving skills allows project administrators to transfer skills within the same project. Skills can be moved to: - -- another subject -- another skill group +* Another subject +* Another skill group When skills are moved: +* Users keep earned points. +* Level-based achievements are recalculated. +* Recalculation applies to both source and destination. -- users keep their points for the moved skills -- level-based achievements are recalculated for both the source and destination subject or group +The ability to move skills between subjects allows project administrators to refine their training profiles after initial creation. -::: 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. -::: - -To move one or more skills please navigate to the Skills page (``Project -> Subject``), then select the skills to move and click -on the Action button located on the top-right above the skills' table. Select the ``Move Skills`` button to initiate the process. - -![Move skills](../../screenshots/admin/page-export-to-catalog.png) +To move one or more skills: +1. Navigate to the Skills page (**Project -> Subject**). +2. Select the skills you want to move. +3. Click the **Action** button above the skills table. +4. Select **Move Skills** to start the process. ::: tip -All the skills under a subject or group can be easily selected via the ``Select All`` button +Select all skills under a subject or group using 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. +You can also move entire Skill Groups. 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.