Organisation de la documentation

Attention : vous consultez actuellement la documentation dédiée aux versions 2.x de Moodle. La documentation pour les versions 3.x de Moodle est consultable ici : Organisation de la documentation.

Cette documentation liée à Moodle 2.x vient d'être ouverte le 19 mars 2012, totalement vide. Tout est donc à mettre en place, et c'est également l'occasion de prévoir l'organisation.

Page d'accueil

Comme sur la version anglaise, plusieurs blocs dès la page d'accueil pour accéder à la plupart des rubriques importantes.

Proposition pour les blocs:

  • En haut: liens vers la doc 1.9.x, vers la doc en anglais et la doc développeur en anglais
  • En 3 colonnes, comme sur la version anglaise.

Organisation générale

Afin de simplifier l'utilisation par un grand nombre de personnes, il me semble qu'il faudrait éviter les majuscules accentuées et préférer les noms courts (au moins dans les noms des modèles et catégories).

Commentaire de Nicolas: OK pour des noms courts. Pour les majuscules, est-ce vraiment une bonne idée ? Je n'aime pas trop les fautes d'orthographe dans les documents publiés.

Catégories

  • Remplacer par exemple "Ébauche" par "Brouillon". Commentaire de Nicolas: est-ce vraiment nécessaire ?

Modèles

  • Remplacer par exemple "En cours de traduction" par "Traduction" (en explicitant sur le modèle ou dans une page d'aide l'utilisation)


Liens

  • On essaie de créer des liens vers les pages existantes

Redirection

  • Je prévois de créer les pages de base, en suivant les "liens vers la documentation"
  • On s'attachera à éviter les doubles redirections.

Restriction des droits sur certaines pages

  • Les pages importantes, par exemple la page d'accueil, ne sont accessibles pour modification que par les admins.

Nettoyage de 1.9

Lorsque des pages ne sont plus adaptées en 1.9 (car c'est une fonctionnalité 2.x), on créera la page en 2.x, puis remplacera celle existant en version 1.9 par une redirection.

Évolution de cette organisation

N'hésitez pas à proposer vos idées, en utilisant la page de discussion...