Skip to content

Commit fb4b764

Browse files
authored
Merge pull request #356 from NationalSecurityAgency/t#351/image_fixes_and_config_docs
T#351/image fixes and config docs
2 parents 1a59e2e + c64cc29 commit fb4b764

2 files changed

Lines changed: 56 additions & 31 deletions

File tree

docs/dashboard/install-guide/config.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -536,6 +536,35 @@ prior giving access to that private project.
536536
skills.authorization.invite.validateEmail=true
537537
```
538538

539+
### Project Expiration
540+
541+
SkillTree allows users to easily experiment with training profiles by creating new projects or copying existing ones.
542+
Given this level of autonomy, organizations may see hundreds or even thousands of projects created.
543+
544+
SkillTree provides a project expiration feature to automatically remove abandoned projects from the system.
545+
546+
You can modify how the project expiration feature works by configuring the following properties:
547+
548+
```properties
549+
# Projects are considered for removal after this many days of inactivity
550+
skills.config.expireUnusedProjectsOlderThan: 180
551+
# After projects are marked for removal, they will not be removed for this many days.
552+
# Project admins are notified daily and given a chance to retain the project.
553+
skills.config.expirationGracePeriod: 7
554+
# Project expiration schedule
555+
skills.config.projectExpirationSchedule: "0 4 0 * * *"
556+
```
557+
558+
If a project has not been used for `expireUnusedProjectsOlderThan` days, it is flagged for removal.
559+
Activity includes editing project definitions on the administration panel or trainees reporting skills.
560+
561+
Once a project is flagged for removal, project administrators are notified and can choose to retain the project.
562+
Notifications are sent via email, so ensure you configure your [email settings](/dashboard/user-guide/settings.html#email-settings) accordingly.
563+
564+
The dashboard user interface will also display a warning message on a flagged project, alongside a button to retain it.
565+
566+
If an administrator does not retain the project within the `expirationGracePeriod` days, the project is permanently removed.
567+
539568
### AI Assistant Configuration
540569

541570
The AI Assistant enhances content creation by generating learning materials automatically. To enable this feature, configure the following settings:

docs/dashboard/user-guide/skills.md

Lines changed: 27 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -329,23 +329,21 @@ If so, those users will *NOT* lose their current level (per our overall strategy
329329

330330
## Same Project Skill Reuse
331331

332-
In-Project Skill Reuse is a feature that facilitates the reuse of skills within the same project.
333-
A skill can be easily reused within another Subject or Skill Group.
334-
Reused skills are read-only copies and cannot be mutated.
335-
As skill occurrences are reported to the original skill they are also automatically propagated to the reused skills.
336-
Changes to the original skill (ex. description, occurrences) are automatically synchronized to all the reused skills as well.
332+
In-Project Skill Reuse allows you to reuse skills within the same project.
333+
A skill can be reused within another Subject or Skill Group.
337334

338-
To reuse a skill navigate to the Skills page (``Project -> Subject``), then select skills to reuse
339-
and click on the ``Action`` button located on the top-right above the skills' table.
340-
Select the ``Reuse in this Project`` button to initiate the process.
335+
Key behavior of reused skills:
336+
* They are read-only copies and cannot be edited.
337+
* Skill actions reported to the original skill propagate to reused copies.
338+
* Changes to the original skill (e.g., description, occurrences) synchronize automatically.
341339

342-
![Reuse skills](../../screenshots/admin/page-export-to-catalog.png)
340+
To reuse a skill:
341+
1. Navigate to the Skills page (**Project -> Subject**).
342+
2. Select the skills you want to reuse.
343+
3. Click the **Action** button above the skills table.
344+
4. Select **Reuse in this Project** to initiate the process.
343345

344-
Once the skills are reused you will see a ``REUSED`` tag next to each skill.
345-
346-
::: tip
347-
All the skills under a subject or group can be easily selected for reuse via the ``Select All`` button
348-
:::
346+
Once skills are reused, a **REUSED** tag will appear next to each copy.
349347

350348
### Skill occurrences propagation
351349
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
378376

379377
## Moving Skills
380378

381-
Moving Skills allows project administrators to move skills within the same project.
379+
Moving skills allows project administrators to transfer skills within the same project.
382380

383381
Skills can be moved to:
384-
385-
- another subject
386-
- another skill group
382+
* Another subject
383+
* Another skill group
387384

388385
When skills are moved:
386+
* Users keep earned points.
387+
* Level-based achievements are recalculated.
388+
* Recalculation applies to both source and destination.
389389

390-
- users keep their points for the moved skills
391-
- level-based achievements are recalculated for both the source and destination subject or group
390+
The ability to move skills between subjects allows project administrators to refine their training profiles after initial creation.
392391

393-
::: tip
394-
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.
395-
:::
396-
397-
To move one or more skills please navigate to the Skills page (``Project -> Subject``), then select the skills to move and click
398-
on the Action button located on the top-right above the skills' table. Select the ``Move Skills`` button to initiate the process.
399-
400-
![Move skills](../../screenshots/admin/page-export-to-catalog.png)
392+
To move one or more skills:
393+
1. Navigate to the Skills page (**Project -> Subject**).
394+
2. Select the skills you want to move.
395+
3. Click the **Action** button above the skills table.
396+
4. Select **Move Skills** to start the process.
401397

402398
::: tip
403-
All the skills under a subject or group can be easily selected via the ``Select All`` button
399+
Select all skills under a subject or group using the **Select All** button.
404400
:::
405401

406402
::: note
407-
You can also move one or more Skill Groups. Please visit
408-
the [Moving Groups Section](/dashboard/user-guide/skills-groups.html#moving-groups) to learn more.
403+
You can also move entire Skill Groups. Visit the [Moving Groups Section](/dashboard/user-guide/skills-groups.html#moving-groups) to learn more.
409404
:::
410405

411406

407+
412408
## Skill Tags
413409

414410
Skill tagging is a feature that allows administrators to add one or more custom "tags" to skills.

0 commit comments

Comments
 (0)