diff --git a/docs/INJECT_process/specify/injects.md b/docs/INJECT_process/specify/injects.md
index 8384e6a7add954966348a78a5a9c9c5d8144adda..2948080d6e18a1df8376a735f4b7d323c6cf2491 100644
--- a/docs/INJECT_process/specify/injects.md
+++ b/docs/INJECT_process/specify/injects.md
@@ -18,17 +18,18 @@
??? "Channels"
- The location within the platform where the inject appears - each inject has just one channel within the exercise. At the same time, you can deliver the same inject information via diffrent channels. The basic channels are:
+ Channels are the locations within the platform where injects appear. Each channel has a name, which can be set to any string, and a type, which defines the form of the injects it contains. The basic channel types are:
- - **Exercise information** – general channel for communication about exercise
+ - **Exercise information** – general channel type for communication about exercise
- **Emails** – classical email communication
- **Tools** - tools outputs
- – **Questions** - a channel where various interactive injects (e.g. questionnaires) are displayed. The channel name can be changed.
- <BR>
- The implementation of media channels is being considered:
+ - **Questions** - a channel type where various interactive injects (e.g. questionnaires) are displayed.
+
+ Media channels can be simulated by creating additional channels of type _Exercise information_. The implementation of a designated media channel type is being considered:
+
- **Website** - for simulating websites of different organizations
- **Intranet**
- - **Social media** / - can be named as X, Facebook, LN, ...
+ - **Social media** - May carry the name of a specific media outlet.
- **Media** - injects in the form of articles, audio or video. May carry the name of a specific media outlet.
@@ -50,8 +51,8 @@ Let's now take a detailed look at the different inject options. This is not a fi
??? "1. Inject option: Email"
### Inject description
This is a classic email conversation. It can also contain email attachments. The sender address is also an important part of this option of inject and is fully configurable. Emails in the form of an inject can be sent either automatically or as an instructor activity.
- ### Channel
- Only a specific channel for emails. The channel functions as a simple email client.
+ ### Channel type
+ Only a specific channel type for emails. It functions as a simple email client.
### Overlay
Emails are usually not used in conjunction with overlays.
### Typical use in an exercise
@@ -76,7 +77,7 @@ Let's now take a detailed look at the different inject options. This is not a fi
??? "2. Inject option: Execise information "
### Inject description
It is used to communicate basic information about the exercise - e.g., introductory inject, contextual information, exercise time shift information, closing information.
- ### Channel
+ ### Channel type
Exercise information.
### Overlay
The Exercise information inject can be displayed as an overlay, this is especially useful for important notifications or hints.
@@ -97,8 +98,8 @@ Let's now take a detailed look at the different inject options. This is not a fi
??? "3. Inject option: Document"
### Inject description
This inject means sending a pdf document to the trainees to read, analyze or make a decision based on it.
- ### Channel
- The document is most often used in the Exercise information channel , but can also be presented in other, more specialized channels such as an intranet or website. Last but not least, it can also be sent by an email or using tools (more in the specific section -> [Tools](../specify/tools.md)).
+ ### Channel type
+ The document is most often used in the Exercise information channel type , but can also be presented in other, more specialized channel types such as an intranet or website. Last but not least, it can also be sent by an email or using tools (more in the specific section -> [Tools](../specify/tools.md)).
### Overlay
It can be used.
### Typical use in the exercise
@@ -106,8 +107,8 @@ Let's now take a detailed look at the different inject options. This is not a fi
### Possible mistakes
- Sending a long document. If you need trainees to read a large amount of text, do everything you can to get them to do so before the exercise - e.g. sending handouts in advance.
### Related manifestations in the platform
- - It depends on which channel you are presenting the document in and what the content is. For example, the document can be initiated by LA, which will be linked to an email response from the instructor, etc.
- - It can be very useful to link to a click on the confirmation button. Imagine a document display with a button below it that says "Done", "Analysis complete", "Understood", "Read", etc. *Please note that this option is not yet implemented.*
+ - It depends on which channel type you are presenting the document in and what the content is. For example, the document can be initiated by LA, which will be linked to an email response from the instructor, etc.
+ - It can be very useful to link to a click on the confirmation button. Imagine a document display with a button below it that says "Done", "Analysis complete", "Understood", "Read", etc.
### Examples
- Incident response plan
- Analysis of the media situation
@@ -122,8 +123,8 @@ Let's now take a detailed look at the different inject options. This is not a fi
??? "4. Inject option: Questionnaire/scale"
### Inject description
Standard questionnaire - single choice or multiple choice. It can also act as a scale.
- ### Channel
- They are displayed in a special channel, which we refer to here as Questions. The channel can of course be called something else.
+ ### Channel type
+ They are displayed in a special channel type, which we refer to here as Questions.
### Overlay
The use is very appropriate.
### Typical use in exercises
@@ -141,13 +142,12 @@ Let's now take a detailed look at the different inject options. This is not a fi
- Etc.
??? "5. Inject option: Decision point"
- ## Not yet implemented
-
+
### Inject description
This is a similar inject to the questionnaire. However, the difference is that some options can be linked to another, automatic response in the platform. The number of options for a decision is 2-5.
- Simple example: decide the situation to communicate YES/NO to the public. If you choose "NO", the platform will respond by receiving an email a few minutes later from a curious journalist who has heard about the situation.
- ### Channel
- These injects are displayed in a special channel, which we refer to here as Questions. The channel can of course be called something else.
+ ### Channel type
+ These injects are displayed in a special channel type, which we refer to here as Questions.
### Overlay
The use is very appropriate.
### Typical use in exercises
@@ -166,11 +166,11 @@ Let's now take a detailed look at the different inject options. This is not a fi
??? "6. Inject option: Free form"
- ## Not yet implemented
+
### Inject description
Inject with open response, can contain input in the form of image, video or text. Trainees respond in the form of free text.
- ### Channel
- These injects are displayed in a special channel, which we refer to here as Questions. The channel can of course be called something else.
+ ### Channel type
+ These injects are displayed in a special channel type, which we refer to here as Questions.
### Overlay
The use is very appropriate.
### Typical use in exercises
@@ -190,10 +190,10 @@ Let's now take a detailed look at the different inject options. This is not a fi
??? "7. Inject option: Media"
## Not yet implemented
### Description of the inject
- Media injects are currently a combination of media outputs and specifically named channels that is an abstraction of a real-world channel (the platform does not attempt to mimic the look of social networks or websites).
- - There may be more than one such channel in each exercise. Let's take a few examples: websites of different organizations, social networks, mass media or intranets. Injects can be in the form of plain text, or graphic materials (e.g. a Facebook post screenshots) or a prepared video can be inserted into the platform.
- ### Channel
- In general, we refer to this channel as "media." It's likely that multiple media channels with different names can be used during the exercise. For example, you could have one media channel called "FB" to display screenshots of FB posts, and another channel for the national cybersecurity authority's website to display warnings.
+ Media injects are currently a combination of media outputs and specifically named channel types that is an abstraction of a real-world media (the platform does not attempt to mimic the look of social networks or websites).
+ - There may be more than one such channel type in each exercise. Let's take a few examples: websites of different organizations, social networks, mass media or intranets. Injects can be in the form of plain text, or graphic materials (e.g. a Facebook post screenshots) or a prepared video can be inserted into the platform.
+ ### Channel type
+ In general, we refer to this channel type as "media." It's likely that multiple media channel with different names can be used during the exercise. For example, you could have one media channel called "FB" to display screenshots of FB posts, and another channel for the national cybersecurity authority's website to display warnings.
### Overlay
It may be appropriate in some cases - e.g. breaking news, warnings, etc. It always depends on the exercise scenario.
### Typical use in exercise:
@@ -214,11 +214,11 @@ Let's now take a detailed look at the different inject options. This is not a fi
- Warning from the IT department on the organisation's intranet.
??? "8. Inject option: Off-platform activity"
- ## Not yet implemented
+
### Inject description
Sometimes it can really make sense to include an off-platform inject. This increases our possibilities for creating interesting scenarios. Technically, this is an instruction in the platform that is combined with a confirmation button. Example: Instruction 'Discuss now three action steps that you could implement in your organization later this month. Once you have that, click on the button." And below that instruction would be a confirmation button "Done".
- ### Channel
- The confirmation button will display in Exercise information channel.
+ ### Channel type
+ The confirmation button will display in Exercise information channel type.
### Overlay
It is very useful for this inject option.
@@ -247,8 +247,8 @@ Let's now take a detailed look at the different inject options. This is not a fi
Example - trainees did not report the incident to management, but should have. The hint can be automated or sent by the instructor on an ad hoc basis.
- **Automated hints:** are set in advance, in response to something happening or not happening by a certain time. These hints are set based on exercise designer intuition about what might be causing the problem or data gathered from earlier runs of the exercise.
- **Ad hoc hints:** are created and sent by the instructor in response to unexpected developments during the exercise.
- ### Channel
- Hints are displayed in the exercise information channel.
+ ### Channel type
+ Hints are displayed in the exercise information channel type.
### Overlay
It is very suitable to use it.
### Typical use in an exercise
diff --git a/docs/images/Logo_BW_inverz.png b/docs/images/Logo_BW_inverz.png
index 75c93107915f6d474217f87703bdfe1112196f7b..e919ac06f27a7d14e29f9917497eda599f4b48e9 100644
Binary files a/docs/images/Logo_BW_inverz.png and b/docs/images/Logo_BW_inverz.png differ
diff --git a/docs/index.md b/docs/index.md
index 17661d111dbb382dcaedcca8c54e63b5ab488401..07e6723505d97aca6fd5d3a87b477812903d2453 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -33,7 +33,7 @@ Welcome! Whether you're responsible for technical deployment or facilitating tab
!!! News
*February 16, 2025*
We've just released the third version of the INJECT Exercise Platform (v 3.0.0). The entire documentation has been updated to reflect this new version.
- If you are using an older version of the platform, please check our [Version Compatibility](tech/version-compatibility.md) page to ensure you are using the correct documentation version.
+ If you are using an older version of the platform, please check our [Version Compatibility](tech/version-compatibility.md) page.
## The Big Picture
diff --git a/docs/license.md b/docs/license.md
index 6f6b92db7062a0e75a61c992f2b78e75698a0e5a..449dae1f79942d06adbf8a013108464ff58e398a 100644
--- a/docs/license.md
+++ b/docs/license.md
@@ -4,7 +4,7 @@ INJECT Exercise Platform is open-source software developed by Masaryk University
## License Terms
-Copyright 2024 Masaryk University
+Copyright 2025 Masaryk University
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/docs/tech/version-compatibility.md b/docs/tech/version-compatibility.md
index 17009f5a266a6e24895032e6f8e95f873c4a4f6b..97f68676a5b3e794f18a581c5c4b451d1e500ca1 100644
--- a/docs/tech/version-compatibility.md
+++ b/docs/tech/version-compatibility.md
@@ -2,12 +2,15 @@
## In a nutshell:
- The INJECT platform comes in different versions
-- Each platform version has a matching documentation version
-- Check the table below to find which documentation version you should use
+- Each platform version has a matching definition versions
+- Check the table below to find which definition version you should use
---
-| Platform Version | Documentation Version |
-|-----------------|----------------------|
-| Up to 0.12.1 | 2.0 |
-| 0.12.1 - (will be specified) | 3.0 |
+| Definition Version | Platform Version |
+|--------------------|------------------|
+| 0.12.1 | 2.0.0 |
+| 0.18.1 | 3.0.0 |
+
+
+[Definition upgrade Guide](architecture/definitions/upgrade.md){ .md-button }
\ No newline at end of file