Guide de rédaction (wiki)

De Wiki1000

Sommaire

 [masquer

Contenu

Ce wiki est destiné aux partenaires et aux clients.

  • Ne pas inclure d'information confidentielle.
  • Ne pas inclure d'information de développement.
  • Ne pas documenter des fonctions qui n'existe pas.
  • Ne pas supposer que le lecteur est un expert ou un abruti.

Pages

  • Le nom de la page doit être significatif et compréhensible
  • Le nom de la page doit inclure la rubrique
Exemple : Paquet métier (model)
  • Toutes les pages doivent être dans au moins une catégorie.
  • Ajouter les catégories à la fin de la page
  • Eviter les pages énormes

Titres

  • Commencer à H2 ==
  • Ne pas inclure de titre principale reprenant le nom de la page

Images et vidéo

Utiliser les templates

{{#images:nom_fichier|répertoire}}
{{#videos:nom_fichier|répertoire|Titre de la vidéo}}
{{#flashs:nom_de_fichier|répertoire|Titre de la vidéo}}
  • Tous les noms de fichier et répertoire doivent être en minuscule (impératifs).
  • Ne pas utiliser d'accents dans les noms de fichier et répertoire.

Utiliser le upload mediawiki

  • Possible pour les images mais pas pour les vidéos.

Nouveauté version

  • Inclure le template new pour afficher une image "nouveauté"

Exemple :

__TOC__
{{new|Tahoe}}
...
[[category:Tahoe]]
  • Inclure la page dans la catégorie de la version
  • Ajouter une entrée dans la page récapitulative de la version
  • Ajouter un pictogramme de version dans le corps du texte avec le template du nom de la version

Exemple :

* [[Importation de documents (import)|Importation de documents]] {{Tahoe}}
Outils personnels