Merge branch 'dmp-refactoring' of https://code-repo.d4science.org/MaDgiK-CITE/argos into dmp-refactoring

docs/docs/documentation/supplementary-services/annotations.md

@@ -1,5 +1,12 @@
 ---
 sidebar_position: 2
+description: Discover everything about the annotations service
 ---
 
-# Annotations
+# Annotations
+
+The `Annotations Service` is responsible to provide commenting capabilities and communication threads to users, that can be attached to any entity.
+
+Currenty, users can communicate in threads that attach to [description template](/docs/documentation/administration/templates/) questions. There is a `comments` button next to the titles of the questions, which brings up a modal with the threads attached to them when clicked. Here, users can either create new threads or respond to existing ones. Comments can also be flaged as `hidden` which makes them visible only to their authors. 
+
+All of this information is getting handled independently of the main platform, using this service.

docs/docs/documentation/supplementary-services/deposit-services.md

@@ -1,5 +1,10 @@
 ---
 sidebar_position: 4
+description: Discover everything about the deposit services
 ---
 
-# Deposit Services
+# Deposit Services
+
+The `Deposit Services` are independent third party services responsible to provide a place to store and validate data objects *(in our case [plans](/docs/documentation/application/plans/))*. They are used as a source of trust and provide a unique key / signature *(called **DOIs** or **D**ata **O**bject **I**dentifiers)* for every data entity deposited to them.
+
+This platform is directly integrated with the [Zenodo](https://zenodo.org/) deposit.

docs/docs/documentation/supplementary-services/file-transformers.md

@@ -1,5 +1,13 @@
 ---
 sidebar_position: 3
+description: Discover everything about the file transformer services
 ---
 
-# File Transformers
+# File Transformers
+
+The `File Transformer Services` are standalone services responsible to provide a way for users to download [plans](/docs/documentation/application/plans/) and [descriptions](/docs/documentation/application/descriptions/) in various file formats. So, their role is to *"transform"* these data structures to these formats.
+
+There are currently two file transformer services implemented and integrated.
+
+- **Docx file transformer service**: Used for PDF files and Word documents.
+- **Rda file transformer service**: Used for JSON files following the RDA specification.

docs/docs/documentation/supplementary-services/notifications/index.md

@@ -1,5 +1,9 @@
 # Notifications
 
+The `Notifications Service` is responsible to inform users about important events taking place in the platform that relate with them. The contents of these notifications can be [configured](/docs/documentation/administration/notification-templates) and they depend on the type of notification. By type, we mean the event that triggered them. For example, if a user gets invited to a [plan](/docs/documentation/application/plans/), this is considered an event and a notification gets pushed to the user it refers to.
+
+The notifications sent, can use one of the following available channels. They can either be `InApp` or `Email`. More detals about these notification channels can be found on the links below.
+
 import DocCardList from '@theme/DocCardList';
 
 <DocCardList />