Nomenclature de Bookstack

La structure de Bookstack

Bookstack est divisée en plusieurs "Shelves", eux-mêmes comprenant plusieurs "Books" qui sont composés de "Chapters" contenant enfin les "Pages", où sont reprises les informations d'utilisation des modules Odoo.

Shelves < Books < Chapters < Pages

Les "Shelves" sont divisés par les flux ou les fonctionnalités principales dont vous avez accès à travers votre Odoo. Par exemple, vous avez la "Gestion des flux d'achats et de ventes" ou encore la "Gestion des Coopérateurs".

Les "Books" composent les "Shelves", ils sont divisés par Applications ou par Concepts principaux nécessaires à la bonne gestion du flux. Par exemple, la "Shelf" "Gestion des flux d'achats et de ventes" est composé de plusieurs "Books" d'Application (Achat, Vente, Inventaire, etc.) ainsi que d'un "Book" nommé "Configurations" nécessaire pour paramétrer les articles et qui possède ainsi le même degré d'importance que les "Books" sur les Applications qui permettent ensemble, la gestion du flux.

Les "Chapters" permettent de faciliter la navigation entre les pages pour la recherche d'information, en regroupant ainsi les pages portant sur le même type d'information. Les "Chapters" portant sur les Applications sont composés de minimum 4 chapitres;

1. le premier chapitre est une "Présentation générale de l'application" comprenant des pages pouvant porter sur les Prérequis nécessaire, les paramètres généraux, une vue rapide des menus et fonctionnalités, etc.
2. le deuxième chapitre porte sur la fonctionnalité principale de l'application (dans la cas de l'application Achat, le chapitre "Gérer mes commandes"). Il peut y avoir plusieurs chapitres si l'application possède plusieurs fonctionnalités "principales".
3. le troisième chapitre est une "Configuration de l'application" contenant les pages qui détaillent la bonne configuration pour permettre l'utilisation de l'application.
4. le quatrième chapitre porte sur les "Fonctionnalités/Modules supplémentaires" à l'application contenant les pages qui détaillent les modules permettant d'étendre les fonctionnalités de l'application.

Les "Pages" contiennent les informations, printscreens et descriptions vous permettant d'utiliser au mieux les fonctionnalités d'Odoo. Les pages contiennent également des liens liants les concepts vers les autres pages où ceux-ci ont déjà été explicités.

Écriture dans Bookstack

Format

Pour faciliter la lecture dans Bookstack, les formats des concepts clefs sont différents.

Ainsi vous trouverez les Applications et Menus dans Odoo en gras.

Les sous-menus sont repris en italiques, tel que le sous-menu Commandes. Également dans les tutoriels Bookstack, les modules supplémentaires cités seront repris en italiques ainsi que les onglets dans les fiches articles, de contacts, de fournisseurs, etc.

Les "pages" dans Odoo sont ensuite reprisent entre "guillemet", tel que la page "Devis", "Commandes", etc.
De plus, lorsqu'il vous est demandé d'effectuer un clic sur une action dans le tutoriel, le bouton à cliquer sera également repris entre "guillemet".

Trajet

Lorsque vous naviguerez dans les pages et tutoriels, il peut vous être demandé d'accéder à une page précise dans votre Odoo. Pour faciliter la lecture, nous utiliserons ce type de trajet ;

Menu < Sous-menu < "Page" ou "Sous-sous-menu" < Page.

- Par exemple, pour accéder aux devis dans l'application Ventes repris ci-dessus,

Ventes < Commandes < "Devis"

- Autre exemple, pour accéder aux catégories d'articles dans l'application Achats ;

Achats < Configuration < "Articles" < Catégories d'articles

Titres

Les titres des pages dans bookstacks sont repris comme suit. Le/s titre/s principal/aux de la page est/sont en Header Medium et vont ensuite en régressant, Header Small, et Header Tiny. 

Callouts

Dans les tutoriels, des informations "plus importantes" seront mises en valeur grâce aux "Callouts", par exemple ;

Des informations reprenant des conseils sur base de notre propre expérience.

Des prérequis, ou informations nécessaires aisément oubliables pour qu'une manipulation dans Odoo fonctionne correctement.

Indications et descriptions

 Dans les tutoriels, lorsqu'il est demandé au lecteur de suivre des indications pour effectuer une tâche, par exemple créer un devis ou modifier des droits d'accès pour un utilisateur, la "Bullet list" est utilisé pour clarifier les étapes.

 Exemple :

• Allez dans Exemple < Exemple < "Exemple"
• Cochez la case "Exemple"
• Introduisez les articles/clients/etc
• etc.
• Cliquez sur "Validez"

La Bullet list est également utilisée pour la description de concept ou de choix à sélectionner par exemple, dans le type d'article sur la fiche d'article, sur la politique de facturation, etc.

Exemple :

• Sélectionnez le type d'article [Ordre]
  • Produit stockable correspond ... [Description]
  • Service est ...
  • Consommable signifie ...