Carnet Wiki

Refonte de spip.net

Version 3 — Janvier 2011 RastaPopoulos

Modifier la structuration du contenu puis sa présentation pour se faire de nouveaux amis.

Constat

Actuellement, le site c’est surtout pour les copains : ceux qui connaissent déjà SPIP et qui viennent alors chercher de la documentation, qui sur l’utilisation, qui sur les squelettes.

Hors spip.net est avant tout l’URL officielle du logiciel, donc celle où arrivent aussi ceux qui ne connaissent pas encore. J’insiste : qui ne connaissent pas DU TOUT.

Il faut donc réorganiser le contenu pour mieux séparer les différentes zones, et dans un deuxième temps réfléchir à comment ce sera présenté à l’écran. Dans l’ordre !

Quelques notes d’analyse

Si l’on regarde différents sites de communautés de logiciels libres, on remarque qu’ils ont des différences, mais que dans les gros sites il y a des points qui reviennent régulièrement.

Alors oui on peut se poser la question : est-ce que cela revient parce que c’est la mode, ou parce que ça marche ? On peut tout de même penser qu’il y a des choses qui fonctionnent, et qui peuvent alors être considérées comme des bonnes pratiques ergonomiques pour diriger un visiteur d’un site de logiciel libre au bon endroit lors de sa première visite.

On retrouve notamment :

  • Présentation du logiciel : « about » dans les sites anglophones, c’est quoi, ça sert à quoi, liste des fonctionnalités, visuels, exemples de site
  • Documentation : il est important ici de d’abord rester dans l’abstrait ! En effet, si au départ il y avait peu de choses, au fil du temps on se retrouve avec moult types de documentations différentes. Il est alors vain de vouloir les afficher directement toutes sur la page d’accueil. Il vaut mieux une entrée sobre et compréhensible par tous « Documentation » qui affichera alors une page qui, elle, redirigera vers les différents types de documentation.
  • La communauté et/ou Contribuer, qui peuvent être la même entrée ou deux entrées différentes, suivant le nombre de choses à placer.

Proposition générale non détaillée

Voici un plan pour les grandes zones. Le but serait de tout faire rentrer dedans. Les titres sont volontairement différents de l’existant pour bien montrer de quoi on parle.

  • Présentation du logiciel
    • Ça sert à quoi
    • Lister les fonctionnalités
    • Exemples de sites qui pètent
    • Historique
    • Ça marche comment
  • Documentation
    • Guide d’installation
    • Guide d’administration
    • Guide de rédaction
    • Guide pour créer ses squelettes
    • Guide pour les développeurs => vers site externe « programmer »
    • Doc automatique du code / API => vers site externe « doc.spip »
    • Vidéos / Screencasts / etc => vers site externe « medias.spip »
  • Aide
    • Lire la doc avant de demander de l’aide
    • Site forums.spip : pour l’aide sur SPIP
    • Les forums de Contrib : pour l’aide sur un plugin précis
    • Les listes
    • IRC
  • Comment contribuer
    • Rapporter des bugs => vers les tickets
    • Aider les utilisateurs => vers « forums.spip » + les listes + IRC
    • Compléter la documentation => ce site + « programmer »
    • Traduire => traduire SPIP + traduire les documentations
    • Développer des choses
      • Pour les plugins => vers « spip-contrib » + « programmer » + la liste « spip-zone »
      • Pour le noyau => vers la liste « spip-dev »

Comme on le voit, certains sites sont cités dans plusieurs endroits : c’est normal. En effet ce n’est pas forcément du même point de vue : comment trouver de l’aide ou comment soi-même apporter de l’aide (contribuer) aux autres. Dans tous les cas, ces points redondants sont des liens vers d’autres sites, et non du contenu interne à spip.net.

Plan complet

Nous allons maintenant détailler le plan pour faire rentrer l’existant dans la structure générale.

Légende : en normal, les entrées qui ne bougent pas, en gras les nouveautés, en italique ce qui est déplacé.

-* C’est quoi SPIP ?

  • Documentation
  • Aide (anciennement Q&R)
  • Contribuer