SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs sur SPIP-Zone, 135 visiteurs en ce moment

Accueil > Vie de SPIP et autour de SPIP > Présentation : Documentation et refonte du portail spip.net

Présentation : Documentation et refonte du portail spip.net

31 mai 2017 – par RastaPopoulos, tcharlss – commentaires

12 votes

Cette présentation a été faite durant la rencontre SPIP à Toulouse en mai 2017.

Elle propose de relancer le chantier de refonte de 2011 qui visait à refaire le portail spip.net et à revoir le rangement de la documentation.

Mieux et plus communiquer est un objectif que nous partageons. Il ne s’agit pas de faire du marketing (littéralement chercher à gagner des parts de marché), même si cela pourra être un « side effect » au passage. Non : il s’agit avant tout de s’adresser et d’accueillir poliment un grand nombre de personnes différentes, venant de plusieurs horizons.
Pas juste des devs, donc.
Et pas juste les gens qui connaissent déjà.

Pour cela, refaire du site officiel un véritable portail d’accueil et de redirection semble une des tâches les plus importantes. Actuellement, il s’agit trop d’un site de documentation pour connaisseureuses.

Nous invitons à relancer le chantier de refonte 2011-2012 dont le but était d’arrêter un moment de documenter, pour ranger autrement. Faire de spip.net un site très léger (à la louche 10-30 pages) donc facile à améliorer maintenant puis au fil du temps.

Voici une feuille de route possible.

  • vider spip.net du maximum, donc facile à améliorer maintenant puis au fil du temps
  • faire un utiliser.spip.net pour la doc d’utilisation de l’interface
  • integrer.spip.net pour la doc du langage de squelettes
  • harmoniser et automatiser ce qu’on doit faire sur les sites de doc dédiés quand on change de version…

Diapositives de la présentation.

Utilisez les flèches droite et gauche pour naviguer, et la flèche du bas sur certaines diapos qui ont des sous-chapitres.

IMG/html/documentation.html
Diapos de la présentation sur la refonte de spip.net

Vidéo de la présentation

Il s’agit d’une première version « brute de pomme ». La version finale comprenant la capture du vidéoprojecteur sera publiée plus tard.

Cette vidéo est également consultable sur medias.spip.net

Présentation : refonte de spip.net et rangement de la documentation
Vidéo de la présentation a été faite durant la rencontre SPIP à Toulouse en mai 2017.

Dernière modification de cette page le 31 mai 2017

Retour en haut de la page

Vos commentaires

  • Le 13 juin à 18:05, par Yohooo En réponse à : Présentation : Documentation et refonte du portail spip.net

    Décentraliser la création de la doc avec la création d’un plugin communautaire :

    Au delà de l’idée de spliter spip.net en 3 parties, pourquoi ne pas créer un plugin permettant de mutualiser une FAQ centrale à partir des articles d’aide utilisé par chaque administrateur de site ?

    Le plugin Aide à la redaction pourrait servir de point de départ.

    Ce plugin serait relié à un site central permettant de récupérer l’ensemble des contributions des administrateur. Il permettrait :
    -  Aux administrateurs d’un site de venir puiser dans les articles composant la FAQ centrale afin de répondre aux problématiques rencontrées par ses utilisateurs.
    -  Aux administrateurs de chaque site de proposer des nouvelles réponses aux problématiques rencontrés par les utilisateurs de leurs sites.

    Exemple :
    En tant qu’intégrateur, je consacre souvent une rubrique des sites réalisés à la doc. ( par exemple, ici ) certains articles se retrouvent sur plusieurs sites et j’aimerai les synchroniser entre-eux lorsque je les améliore. ( par exemple, cette notice d’aide à l’utilisation de formidable se retrouve ici ).

    Les articles composant la FAQ pourraient avoir plusieurs statuts :

    • Mutualisation descendante : l’article est publié sur le site, il se synchronise à chaque mise à jour sur le site central
    • Proposé à la Mutualisation : l’article est publié sur le site. Il va être pris en compte pour une modification du site global
    • Article spécifique au site : article non mutualisé

    par ailleurs, les articles pourraient être associé à deux autres types de statut :

    • Un premier type de statut nommé « plugin nécessaire à cette doc » permettant d’afficher certains articles sur une partie spécifique du site central.
    • Un second type de statut nommé « version de Spip » pourrait limiter la doc à une ou plusieurs version de spip

    Enfin, il serait peut-être opportun de créer des noisettes relatives aux plugins et aux versions de Spip pour faire apparaître certains paragraphes. par exemple :

    1. <spipsup3.0>
    2. L'ensemble des documents hébergés sur votre site sont visibles et modifiables dans la médiathèque. Pour y accéder, RDV dans {{Edition > Document}}
    3. </spipsup3.0>

    Télécharger

    Dynamique communautaire

    Ce type de plugin permettrait d’impulser une dynamique visant à la production communautaire d’une doc de spip. L’équipe d’admin du site central n’aurait plus qu’à valider et structurer un contenu arrivant directement sur le site d’aide et basé sur des problématiques concrètes.

    Les contributeurs réguliers seraient contactés pour devenir à leur tour administrateur du site.

    Z’en pensez quoi ?

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?
  • [Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Acces Restreint 3.0

    11 décembre 2008 – 813 commentaires

    Le plugin accès restreint permet de définir et de gérer des zones de l’espace public en accès restreint. Cette version du plugin a été redévelopée et optimisée tout spécialement pour SPIP 2.0. Il en découle une amélioration des performances sur les gros (...)

  • SpipClear 2.1

    18 avril 2009 – 138 commentaires

    Un squelette de blog parmi les autres, entièrement pompé (avec la permission du concepteur) sur le thème par défaut de DotClear.

  • Mailsubscribers

    16 janvier 2013 – 328 commentaires

    Ce plugin permet de gérer les inscriptions (ou abonnements) à la diffusion de contenu par email. Mailsubscribers permet de gérer les inscriptions par Opt-in simple ou double et la désinscription par URL. Ce plugin gère également plusieurs listes de (...)

  • Minidoc : différentes vues pour les documents attachés

    3 février – commentaires

    Minidoc est un plugin pour SPIP 3.1 qui ajoute aux listes de documents attachés à des objets éditoriaux (tel que les articles), des boutons permettant de changer le type d’affichage de ces listes. Il a été intégré dans le plugin Médias inclu avec SPIP (...)

  • Agenda 2.0

    3 novembre 2008 – 1095 commentaires

    Voici la version pour SPIP 2.0 du Plugin Agenda pour SPIP 1.9.2, avec une interface remaniée pour encore plus de plaisir. Pour une documentation concernant l’utilisation d’Agenda 3 pour SPIP 3, veuillez pour l’instant vous référer à SPIP 3, Agenda (...)