add composition work around

bowiedocs/docs/1._Pogues/Le guide/26-composition.md

@@ -1,9 +1,5 @@
 # La composition
 
-!!! tip
-
-    Nouvelle fonctionnalité disponible avec la version __1.1.0__ de Bowie
-
 Pour rendre la conception d'un questionnaire plus flexible, il est possible d'y importer d'autres questionnaires. On _compose_ ainsi un questionnaire à partir de multiples sources.
 
 ## Les principes
@@ -62,3 +58,83 @@ Une fois la référence ajoutée, le questionnaire hôte peut mobiliser :
 Il est également possible de filtrer une référence. :point_down:
 
 ![Filtre sur référence](../../img/pogues/composition-filtre.png)
+
+## Précautions et "bonnes pratiques"
+
+### Boucles 
+
+On appelle boucle, le questionnement répétitif d’un ensemble de questions. Cet ensemble de questions pour une répétition donnée est appelée une **occurrence** de boucle.
+Dans Pogues, une boucle ne peut être construite qu'a partir de séquences (ou sous-séquences) entières.
+L'atelier de conception propose deux types de boucles : 
+
+- une boucle dite simple pour laquelle on définit un nombre minimum et un nombre maximum d’occurrences affichables, en absolu (numérique) ou avec une variable collectée ou calculée ;
+- une boucle dite liée qui se base sur les occurrences d'une boucle précédente. Dans ce cas, la première est la boucle principale
+Exemple dans le TCM : la boucle principale est la liste des prénoms, une boucle liée peut être une boucle sur l'état de santé de chaque individu
+
+Pour créer une "boucle liée", il est nécessaire d'avoir déjà créé la boucle principale, qui peut avoir été décrite dans un questionnaire précédent. Donc il ne sera pas possible de créer une boucle liée sur un questionnaire "isolé"
+
+!!!note
+
+    Il est également possible de créer une boucle liée à partir d'un tableau dynamique.<br>
+    Chacune des lignes du tableau est équivalent à une occurrence de la boucle principale.<br>
+    ⚠️ Pour avoir un comportement similaire à ce qui est décrit au dessus, le tableau dynamique ne doit pas être peuplé par une variable externe mais par une variable collecté. <br>
+    Ce fonctionnelle avec un vecteur injecté sous forme de variable externe n'est pas encore supporté.
+
+### Gestion des doublons d'identifiant
+
+#### Listes de codes et référence au questionnaire d'origine
+
+A la création d'une liste de codes, est créé un identifiant technique non affiché dans Pogues.<br>
+Lorsqu'on duplique un questionnaire, cet identifiant est conservé.<br>
+Lorsqu'on compose un questionnaire qui utilise le questionnaire d'origine et le questionnaire dupliqué, on a alors un souci de doublons.
+
+??? success "Solution"
+    **=> Utiliser le bouton de duplication de liste de code**
+    ![duplication liste code case non cochée](../../img/pogues/duplication-liste-code-case-non-cochee.png)
+
+    - Juste après avoir coché la case un `_2` est rajouté à la fin du nom. Il est possible de le changer juste après
+
+    ![duplication liste code case cochée](../../img/pogues/duplication-liste-code-case-cochee.png)
+
+    - On peut ensuite régénérer les variables calculées et valider les modifications. :tada: Plus de problèmes de doublons
+
+
+#### Séquences et Sous-Séquences
+
+Comme pour les listes de codes, les identifiants des séquences et sous séquences des questionnaires dupliqués restent les mêmes.
+
+Il n'existe pas de moyen pratique pour y remédier autre que supprimer le séquence/sous-séquence et la recréer.
+
+!!! tip "Astuce"
+    1. Se placer sur la séquence/sous-séquence en question
+    2. Créer une séquence/sous-séquence. Cette dernière va apparaître juste au dessus de celle sélectionnée.
+    3. Changer les noms en conséquence.
+    4. Supprimer l'ancienne séquence/sous-séquence
+
+
+### Duplication pour sauvegarde
+
+Attention à la duplication également lorsqu'on veut "sécuriser" son questionnaire. La composition se fait par référence.
+
+??? example "Exemple"
+    si C est la composition de A et B, alors C fait référence aux ids de A et de B (`id_A` et `id_B` par ex).<br>
+    Si je duplique A en AA, B en BB, je crée 2 nouveaux id, `id_AA` et `id_BB` et que je modifie AA et BB, C faisant toujours référence par composition à `id_A` et `id_B`, donc à A et B, il n'aura pas les modifications contenus dans AA et BB.
+
+
+### Variables créées dans un questionnaire et utilisées dans un autre
+
+Un questionnaire qui sera utilisé dans un questionnaire hôte peut avoir des parties filtrées ou des variables calculées, utilisant les variables d'une autre partie de questionnaire : 
+- on peut, dès le début de la description du questionnaire dans Pogues, faire appel à ces variables provenant d'un autre questionnaire mais  elles ne seront pas valorisées lors de la visualisation Pogues du questionnaire "de base".
+
+- pour les valoriser et donc aller plus loin dans les tests : 
+    - soit on les décrit comme variables externes - penser ensuite à les supprimer quand la composition commence
+    - soit on crée des variables collectées "temporaires" en début de questionnaire
+
+
+### Travail collectif avec composition
+
+- s'accorder sur le nommage des variables, des listes : 
+    - ne pas créer de variables T_ car réservées aux variables TCM
+    - ne pas utiliser de -, de minuscules
+    - nommer les listes au format L_ 
+- savoir qui travaille sur quel questionnaire