Atelier Documentation

La syntaxe dokuwiki est ici

Répartition des tâches

Présentation

A créer de toutes pièces, voir avec Olivier pour l'upload des images. Noé, un court texte en gros pour expliquer que les données sont en base, les fichiers de traitement dans l'appli, et des liens vers le glossaire (que nous aurons à créer) pour FTP, chmod et autres grossièretés.

  • Overview : Philippe
  • Comment ça marche ? : Noé

Utilisation

Le manuel est à piocher sur preview, pour la FAQ, voir le forum et la FAQ de Gandi ici et . Pour Mon premier billet voir avec Olivier pour l'upload d'images.

  • Manuel : Alain et Anne
  • FAQ : Bruno, Franck, Alain et Anne
  • Mon premier billet : Franck

Administration

Le gros est déjà sur preview, j'aimerais qu'on y ajoute une page Permissions expliquant en partant de la liste des permissions ce que permet telle ou telle, avec lien sur l'article de la doc correspondant. Pour la FAQ, piocher sur le forum. Compléter les install par hébergeurs si possible

  • Guide : Benoit, Noé et Xave
  • FAQ : Bruno, Xave, Noé et Benoit

Documentation contributeurs

Xave pour établir le sommaire.

Toute la team pour la rédac, à voir entre vous pour vous organiser.

Règles de présentation

Structure

Chaque section de la doc a une page racine sur laquelle figure le sommaire complet de la section (voir exemple pour la page http://doc.dotclear.net/utilisation )

Chaque section est un namespace. On a donc des URLs de pages de la forme http://doc.dotclear.net/utilisation:billets par exemple, auxquelles on ajoute des ancres pour les sous-sections de la même page : http://doc.dotclear.net/utilisation:billets#creation_et_edition

La structure sur la page d'accueil de la doc vous permet de voir l'arborescence selon laquelle créer les pages.

J'ai détaillé pour Utilisation, à vous de faire pour les autres.

Présentation

Les menus à droite sont créés automatiquement en fonction de la hiérarchie de la page, vous n'avez donc pas à vous en occuper.

Le titre de la page est de niveau h1.

En dehors des pages « Comment ça marche ? » et « Mon premier billet »,

  • on rédige sobrement,
  • on renvoie si besoin sur une entrée de glossary (qu'on complète immédiatement),
  • on pose des liens vers les autres parties de la doc quand c'est utile
  • si on se dit que tel point risque d'amener des questions, on ajoute le binz dans la FAQ de la section

Discussion

Je vous écoute ;)

Anne : pour Olivier, j'ai vu ces deux plugins qui me semblent intéressants, mais je ne sais pas ce qu'ils valent : export en pdf et ajouter un onglet discussion.

Wiki powered by Dokuwiki.