Rédiger une documentation utilisateur

Lorsqu'on rédige à l'aide de Dokiel, qui est une chaîne éditoriale, on construit un document éclaté en plusieurs fichiers ou, pour adopter le vocabulaire Dokiel, en plusieurs items.

C'est un changement de mode de rédaction par rapport à la rédaction à partir d'un logiciel de bureautique où les contenus sont tous saisis les uns à la suite des autres et donc regroupés au sein d'un seul et même document. L'avantage de cet « éclatement » est de permettre une gestion modulaire des contenus. Le rédacteur peut en effet définir la création d'objets qui pourront être réutilisés dans un autre contexte pour un autre document.

De prime abord, la gestion des contenus paraît complexe. En réalité elle aide dans la structuration ou l'organisation de ses contenus. Il convient d'être rigoureux. La logique de classement est similaire à celle du classement dans des répertoires, dossiers, sous-dossiers, fichiers de son ordinateur personnel. Au commencement, elle passe par la création d'espaces pour organiser ses fichiers.