La rédaction sur le wiki doit faire l'objet d'un soin minutieux. Elle doit chercher à atteindre les quatre objectifs suivants :
Attention à la qualité de la langue : orthographe, syntaxe, construction des phrases et des paragraphes. Évitez la verbosité (“Il semble que la perfection soit atteinte non quand il n'y a plus rien à ajouter, mais quand il n'y a plus rien à retrancher.”).
Détourez les copies d'écran avec précision (utilitaire vivement recommandé : Faststone Capture). Format recommandé : png (apparemment plus performant que du jpg sur des copies d'écran). Nommer les images avec un nom en rapport, par exemple pour la page famille de produit, famprod_01.png, famprod_02.png, etc, pour les images figurant sur une même page). Les stocker dans le même namespace.
Pour mettre des zones en évidence dans la copie d'écran, utilisez la fonction de numérotation de FastStone capture, et la notation correspondante : 1.
Pour tout ce qui est libellés de bouton ou de champs, ainsi que les libellés des champs, mettez les en gras. Par exemple : “cliquez sur le bouton Valider”.
Les liens vers des sites externes ne sont pas autorisés : la documentation est uniquement sur le wiki. Le seul lien autorisé est celui du formulaire d'achat quand l'extension est en vente via le site du partenaire.
Ci-dessous une page standard de documentation concernant une extension.
Cette extension permet de […détailler ici les fonctionnalités principales de l'extension…].
Vous pouvez mettre une video si vous en avez fait une.
Accès : Outils → Paramètres → Paramétrage des extensions → Extension.
Détaillez ici le paramétrage :
Accès : Outils → Paramètres → Paramétrage des extensions → Extension.
Détaillez ici le fonctionnement de l'écran.
Détaillez ici le fonctionnement de l'écran.
| Version | Date | Observations |
|---|---|---|
| 3.15.xx.00 | 00/00/00 | Première version de production sans trop de bugs ennuyeux |
Autres articles “Extensions”