Achieve profile section

Author: Guts

docs/index.md

@@ -74,6 +74,7 @@ caption: Miscellaneous
 maxdepth: 1
 ---
 misc/compatibility
+misc/tip_get_plugin_id
 misc/credits
 misc/funding
 ```

docs/misc/tip_get_plugin_id.md

@@ -0,0 +1,8 @@
+# How to get a plugin ID
+
+1. Open the repository in your browser. Example for the official set on QGIS 3.28: <https://plugins.qgis.org/plugins/plugins.xml?qgis=3.28>
+1. Open the RAW mode (or source), typing `Ctrl + U` or right-click and  select `View page source`
+1. Use your browser search `Ctrl + F` to look for the plugin you want
+1. Grab the `plugin_id` attribute:
+
+  ![Plugin ID into official repository - Example QuickOSM](/static/repository_plugins_plugin_id.webp)

docs/usage/how_it_works.md

@@ -2,15 +2,25 @@
 
 ## Concepts
 
-To run the workflow properly, you will need 3 items:
+To run the workflow properly, you need 3 items:
 
 | QGIS profiles | A scenario | The QDT executable |
-| -- | -- | -- |
+| ------------- | ---------- | ------------------ |
 | ![icon profiles](/static/icon_profiles.svg) | ![icon scenario](/static/icon_scenario.svg) | ![icon QDT](/static/logo_qdt.png) |
 
 ### QGIS profiles
 
-> TO DOC
+One of the most interesting aspects of QGIS when it comes to deploying it to a large number of users is the ability to provide them with one or more customised experiences via [the profile system](https://docs.qgis.org/latest/en/docs/user_manual/introduction/qgis_configuration.html). A profile contains many settings: interface items, installed and deactivated plugins, variables, network settings, etc.
+
+To facilitate their management and administration, QDT uses a profile definition file in JSON format (`profile.json` stored in the profile folder) which then serves as a "recipe" at the time of installation and especially when updating a profile.
+
+```{button-link} ./profile.html
+:color: primary
+:shadow:
+:expand:
+
+Publish your QGIS profiles
+```
 
 ### Scenarios
 
@@ -60,7 +70,7 @@ flowchart TB
             E1[QDT executable + scenario.qdt.yml]
             E2{RUN<br>cron / manual double-click}
             E3[Read scenario]
-            E3>Set persistent environment variables]
+            E4>Set environment variables]
             E5>Sync local profiles from repo]
             E6>Download and install plugins locally]
             E7>Create shortcuts to profiles]

docs/usage/profile.md

@@ -8,7 +8,7 @@ QDT expects to find this file in the folder of each profile stored in the source
 
 ## Publish them
 
-> TO DO
+----
 
 ## Good practices and recomendations
 
@@ -17,15 +17,6 @@ QDT expects to find this file in the folder of each profile stored in the source
   - QGIS will fill them automatically if needed
   - it reduces the surface of possible conflicts when dealing to upgrade a profile
 
-## How to get a plugin ID
-
-1. Open the repository in your browser. Example for the official set on QGIS 3.28: <https://plugins.qgis.org/plugins/plugins.xml?qgis=3.28>
-1. Open the RAW mode (or source), typing `Ctrl + U` or right-click and  select `View page source`
-1. Use your browser search `Ctrl + F` to look for the plugin you want
-1. Grab the `plugin_id` attribute:
-
-  ![Plugin ID into official repository - Example QuickOSM](/static/repository_plugins_plugin_id.webp)
-
 ----
 
 ## Model definition
@@ -44,6 +35,10 @@ With a submodel for plugin object:
   :language: json
 ```
 
+:::{tip}
+To retrieve the ID of a plugin see [this page](../misc/tip_get_plugin_id.md).
+:::
+
 ----
 
 ## Sample profile.json