Tâches complexes imbriquées

Un processus complexe composé de plusieurs procédures peut être documenté en regroupant les rubriques task constitutives, via la carte DITA, dans une rubrique d'introduction au processus.

Les tâches sont parfois différenciées entre les procédures et les processus. Dans ce cas, les processus sont des aperçus généraux d'un ensemble de procédures, alors que les procédures sont des instructions détaillées permettant d'effectuer une tâche.

Un processus peut être documenté en utilisant un type d'information task dans lequel chaque étape du processus est en corrélation avec une procédure.

Figure 1: Relation structurelle entre processus et procédure

Schéma présentant la relation structurelle entre processus et procédures

Bien qu'il soit possible de créer un lien hypertexte entre les étapes individuelles du processus et la rubrique procédure correspondante, ce n'est pas recommandé. Évitez également d'introduire une section related-links dans la rubrique processus pour la lier aux rubriques procédure associées.

La meilleure méthode est de laisser la rubrique générale processus comme rubrique d'introduction, contenant le minimum d'information (en général un titre et une description courte). Le type d'information de la rubrique processus doit être soit concept soit task. Les rubriques procédures doivent être organisées comme les rubriques enfants de la rubrique processus dans la carte DITA ; l'attribut collection-type de la rubrique (parent) processus doit être paramétré sur sequence. Grâce à cette organisation, les étapes du processus sont automatiquement générées lors du traitement et les étapes sont basées sur les titres des rubriques procédure enfants. Si des descriptions courtes sont comprises dans les rubriques procédures, elles seront également incluses dans les étapes du processus. Le paramètre sequence organisera les liens générés en une liste numérotée.

L'approche rubrique d'introduction pour les processus offre une réutilisation beaucoup plus facile et ôte le besoin de ré-identification des étapes du processus. Si une des procédures n'est pas utilisée dans un scénario de publication particulier, la rubrique processus n'aura pas besoin d'être éditée.

Figure 2: Exemple d'une rubrique d'introduction après le traitement

Exemple d'une rubrique d'introduction (contenant juste un titre et une description courte) après le traitement,