Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions docs/dashboard/install-guide/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
58 changes: 27 additions & 31 deletions docs/dashboard/user-guide/skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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.
Expand Down
Loading