# Documentation et refonte du portail spip.net ![Gentil polatouche](https://f.ldd.fr/images/spipoulet/polatouche-1.png)
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 d'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. Nous proposons de faire un rappel historique de ce projet, puis d'évoquer une feuille de route possible.
# 1. Le site actuel ![Site actuel](https://f.ldd.fr/images/spipoulet/documentation/site-actuel.jpg)
## 1.1. Des problèmes * Plutôt destiné aux habitué.e.s qui connaissent déjà SPIP → peu accueillant pour les nouveaux venus. * Beaucoup de contenu → compliqué de s'y retrouver <!-- .element: class="fragment" --> * Pas de documentation propre à chaque version de SPIP <!-- .element: class="fragment" --> * Un peu austère et désuet <!-- .element: class="fragment" -->
## 1.1. Un projet de refonte Rappel du projet existant qui a été initié en ~2011-2012 mais jamais abouti. URL
## 1.2. Structure actuelle Il y a 5 grandes branches : 1. C'est quoi SPIP : présentation générale, voir, installation, évolutions et mises à jours 3. Utiliser SPIP : premiers pas, guide du rédacteur, aller plus loin 4. Webmestres : squelettes, manuel de référence boucles et balises, exemples de boucles, fonctions avancées, itérateurs, habillage graphique 5. Contribuer : traduire, développement et outils 6. Questions et réponses : faq technique, forums
![Structure actuelle](https://f.ldd.fr/images/spipoulet/documentation/structure-actuelle.jpg)
# 2. Solution possible
* Relancer le chantier de refonte 2011-2012 * Arrêter un moment de documenter, pour ranger autrement * Faire de spip.net un véritable portail d'accueil et de redirection * Un site très léger donc facile à améliorer et à maintenir au fil du temps * __Répartir le reste en plusieurs sites (autres sous-domaines)__
## 2.1. spip.net * Site __super allégé__, ~10/30 pages à la louche. Donc __le vider au maximum__. * Page d'accueil qui **explique et montre** de façon concise ce qu'est SPIP et ce qu'on peut faire avec. * Liens vers les principaux sites de la galaxie. * Notes de version de chaque releases.
![Structure de spip.net](https://f.ldd.fr/images/spipoulet/documentation/structure-spip.jpg)
## 2.2. utiliser.spip.net Documentation d'utilisation de l'interface, orientée utilisateurs. * Gestion du contenu éditorial * Interface d'édition * Les raccourcis typographiques * La gestion des documents * Installation * etc.
![Utiliser](https://f.ldd.fr/images/spipoulet/documentation/structure-utiliser.jpg)
## 2.3. integrer.spip.net Documentation du langage des squelettes, orientée intégrateurs. * Introductions aux squelettes * Documentation des boucles, balises, critères, filtres * Étendre SPIP (fonctions et plugins). * Glossaire
![Integrer](https://f.ldd.fr/images/spipoulet/documentation/structure-integrer.jpg)
# Quelques exemples d'autres CMS
## Concrete5 ![Homepage Concrete5](https://f.ldd.fr/images/spipoulet/documentation/homepage-concrete5.jpg)
![Documentation Concrete5](https://f.ldd.fr/images/spipoulet/documentation/documentation-concrete5.jpg)
## EZ Publish ![Homepage EZ Publish](https://f.ldd.fr/images/spipoulet/documentation/homepage-ezpublish.jpg)
![Documentation EZ Publish](https://f.ldd.fr/images/spipoulet/documentation/documentation-ezpublish.jpg)
## Neos ![Homepage Neos](https://f.ldd.fr/images/spipoulet/documentation/homepage-neos.jpg)
![Documentation Neos](https://f.ldd.fr/images/spipoulet/documentation/documentation-neos.jpg)
## Prestashop ![Homepage Neos](https://f.ldd.fr/images/spipoulet/documentation/homepage-prestashop.jpg)
![Documentation Neos](https://f.ldd.fr/images/spipoulet/documentation/documentation-prestashop.jpg)
## Wordpress ![Homepage Neos](https://f.ldd.fr/images/spipoulet/documentation/homepage-wordpress.jpg)
![Documentation Neos](https://f.ldd.fr/images/spipoulet/documentation/documentation-wordpress.jpg)
## Drupal ![Homepage Neos](https://f.ldd.fr/images/spipoulet/documentation/homepage-drupal.jpg)
![Documentation Neos](https://f.ldd.fr/images/spipoulet/documentation/documentation-drupal.jpg)
# Feuille de route possible * Vider spip.net du maximum * 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… * Se retrouver alors avec un spip.net ne contenant plus que très peu de pages, léger, donc facile à améliorer maintenant puis au fil du temps