SPIP-Contrib

SPIP-Contrib

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

290 Plugins, 198 contribs sur SPIP-Zone, 90 visiteurs en ce moment

Accueil > Vie de SPIP et autour de SPIP > Pistes d’évolution pour 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 28 septembre 2018

Retour en haut de la page

Vos commentaires

  • Le 13 juin 2017 à 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 ?

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

  • MediaBox

    10 mai 2010 – 539 commentaires

    Avertissement Le présent plugin est installé et activé par défaut sur toute les version de SPIP > 3.0. Inutile donc de l’installer manuellement sauf si vous utilisez SPIP 2.1. Aperçu La MediaBox est une Boîte multimédia polyvalente et (...)

  • DocumentationFormsTables

    9 décembre 2006 – commentaires

    Article publié : ces notes et d’autres sont désormais publiées sur SPIP-Contrib ici Forms & tables - carnet de notes, donc il faut mieux y aller pour tout complément Différence entre un formulaire et une table un formulaire est dédié a la saisie (...)

  • GIS 4

    11 août 2012 – 1495 commentaires

    Présentation et nouveautés La version 4 de GIS abandonne la libraire Mapstraction au profit de Leaflet. Cette librairie permet de s’affranchir des librairies propriétaires tout en gardant les mêmes fonctionnalités, elle propose même de nouvelles (...)

  • Editer votre base « en ligne » avec Adminer

    4 décembre 2012 – 10 commentaires

    Vous serez peut-être un jour amené à chercher un outil qui permette d’éditer en direct le contenu de cette base de données. Cet article vous propose de le faire avec Adminer qui permet d’éditer des bases MySQL et SQLite ! Son utilisation est assez (...)

  • cisf : plugin « saisie facile » pour SPIP 3

    27 mai 2015 – 128 commentaires

    Cette nouvelle version est compatible avec SPIP 3.0, SPIP 3.1 (tout en restant compatible avec SPIP 2.1). Ce plugin « saisie facile » permet de créer ou de modifier facilement un article directement depuis le site public. Ce plugin : Diminue le (...)