spip-contrib - cavernes aux boucles - profil d?butant

Bonjour,

Attention, ce qui suit n'est pas un troll, c'est juste quelques réflexions
nées à l'utilisation du forum.spip.org où je m'efforce en fonction de mes
connaissances de répondre aux messages. Mon intention n'est donc pas de
donner une poussée d'urticaire à quiconque, encore moins de froisser ceux
qui oeuvrent sur spip-contrib et spip.net, nul intention de remise en cause.
Ok ?

Donc, la répétition de certaines questions m'ont donner "envie" de voir sur
« spip-contrib » ou « spip.net » un affichage en page d'accueil titrant
quelque chose comme « Les ressources pour découvrir SPIP ». Car la matière
existe pour les débutants mais sans doute pas suffisamment fléchée et trop
dispersée.

Dans cet esprit, je trouve dommage que la page « cavernes aux boucles » sur
spip-contrib donne un résultat 404... pour ma part, je suis entré doucement
dans la construction d'un squelette en faisant des copier/coller et en
modifiant les boucles que je trouvais, notamment, dans cette rubrique jusqu'à
pouvoir m'en affranchir et à en créer une en partant de zéro. Quand on a pas
un bagage de programmeur, la bouclothèque permet d'obtenir un résultat
rapidement et de faire ses classes... :slight_smile:

Comme une part des messages des forums portent sur des cas de figure, des
applications des boucles... une bouclothèque permettrait d'offrir de
multiples exemples concrets d'utilisation face à un manuel de référence vécu
parfois comme trop aride parce que trop théorique (et c'est normal) ou
alors, parfois on comprend ce que dit le manuel, mais on ne visualise pas l'application
et donc le bénéfice que l'on peut en tirer. Une bouclothèque est un espace à
vocation pédagogique, à la différence d'une rubrique de contrib' ou de
plugin qui ajoute quelque chose au script pour faire avancer la
communauté...

Concrètement, une approche profil débutant, c'est mettre en avant une page
"sommaire" avec un minimum d'habillage... comme celle-ci qu'il faudrait
mettre à jour... http://www.spip-contrib.net/SPIP-par-le-debut

A vous lire,

Cordialement

Stanislas

Pour ma part je suis tout à fait d'accord avec Stanislas (comme souvent, il faut bien le dire, Stanislas a l'oeil et le recul qui permettent de trouver ce qui facilite la comprehension).

Je ne sais pas quelles sont les modalités qui seraient les plus performantes et s'il faut exhumer la caverne au boucle et la bouclotheque (je serai pour à brule pour point, mais je n'y ai pas tellement réfléchi) mais effectivelent, spip-contrib gagnerait à avoir une ou deux entrée thématiques sur la page d'accueil, distinctes dans la présentation de celles qui y sont déjà, et présentée en tant que telles. (avec une couleur spéciale ou autre).

Dans le meme genre, il manque peut etre egalement une entree pour les tres forts en code, qui amenerai vers la doc plugin et autre doc.spip.org.

Ce dernier site est en fait un wiki (j'ai appris ca hier !!) ou l'on est supposé documenter les fonctions du core de spip (si on y comprends qqch bien sur ^^).

BoOz

Stanislas a écrit :

Bonjour,

Attention, ce qui suit n'est pas un troll, c'est juste quelques réflexions nées à l'utilisation du forum.spip.org où je m'efforce en fonction de mes connaissances de répondre aux messages. Mon intention n'est donc pas de donner une poussée d'urticaire à quiconque, encore moins de froisser ceux qui oeuvrent sur spip-contrib et spip.net, nul intention de remise en cause. Ok ?

Donc, la répétition de certaines questions m'ont donner "envie" de voir sur « spip-contrib » ou « spip.net » un affichage en page d'accueil titrant quelque chose comme « Les ressources pour découvrir SPIP ». Car la matière existe pour les débutants mais sans doute pas suffisamment fléchée et trop dispersée.

Dans cet esprit, je trouve dommage que la page « cavernes aux boucles » sur spip-contrib donne un résultat 404... pour ma part, je suis entré doucement dans la construction d'un squelette en faisant des copier/coller et en modifiant les boucles que je trouvais, notamment, dans cette rubrique jusqu'à pouvoir m'en affranchir et à en créer une en partant de zéro. Quand on a pas un bagage de programmeur, la bouclothèque permet d'obtenir un résultat rapidement et de faire ses classes... :slight_smile:

Comme une part des messages des forums portent sur des cas de figure, des applications des boucles... une bouclothèque permettrait d'offrir de multiples exemples concrets d'utilisation face à un manuel de référence vécu parfois comme trop aride parce que trop théorique (et c'est normal) ou alors, parfois on comprend ce que dit le manuel, mais on ne visualise pas l'application et donc le bénéfice que l'on peut en tirer. Une bouclothèque est un espace à vocation pédagogique, à la différence d'une rubrique de contrib' ou de plugin qui ajoute quelque chose au script pour faire avancer la communauté...

Concrètement, une approche profil débutant, c'est mettre en avant une page "sommaire" avec un minimum d'habillage... comme celle-ci qu'il faudrait mettre à jour... http://www.spip-contrib.net/SPIP-par-le-debut

A vous lire,

Cordialement

Stanislas

BoOz a écrit :

Je ne sais pas quelles sont les modalités qui seraient les plus performantes et s'il faut exhumer la caverne au boucle et la bouclotheque (je serai pour à brule pour point, mais je n'y ai pas tellement réfléchi) mais effectivelent, spip-contrib gagnerait à avoir une ou deux entrée thématiques sur la page d'accueil, distinctes dans la présentation de celles qui y sont déjà, et présentée en tant que telles. (avec une couleur spéciale ou autre).

Il y a peut-être encore de la place dans le bandeau entre le lien du "glossaire" et les liens "téléchargement" et "plugin zone"

Une bouclothèque et des tutoriaux faciles à trouver, c'est une bonne idée.

Dans le meme genre, il manque peut etre egalement une entree pour les tres forts en code, qui amenerai vers la doc plugin et autre doc.spip.org.

J'en suis moins sur

BoOz

Stanislas a écrit :

Bonjour,
Donc, la répétition de certaines questions m'ont donner "envie" de voir sur « spip-contrib » ou « spip.net » un affichage en page d'accueil titrant quelque chose comme « Les ressources pour découvrir SPIP ». Car la matière existe pour les débutants mais sans doute pas suffisamment fléchée et trop dispersée.

En effet :slight_smile:

Dans cet esprit, je trouve dommage que la page « cavernes aux boucles » sur spip-contrib donne un résultat 404... pour ma part, je suis entré doucement dans la construction d'un squelette en faisant des copier/coller et en modifiant les boucles que je trouvais, notamment, dans cette rubrique jusqu'à pouvoir m'en affranchir et à en créer une en partant de zéro. Quand on a pas un bagage de programmeur, la bouclothèque permet d'obtenir un résultat rapidement et de faire ses classes... :slight_smile:

Tu serais disponible pour t'en occuper et décharger un peu NicolasR ? Se serait pas mal d'avoir des administrateurs "spécialisés" non ?

Concrètement, une approche profil débutant, c'est mettre en avant une page "sommaire" avec un minimum d'habillage... comme celle-ci qu'il faudrait mettre à jour... http://www.spip-contrib.net/SPIP-par-le-debut

Même si je suis d'accord et qu'il faudra modifier le texte, tu peux commencer par mettre des commentaires sur ce qu'il manque ou ce qui est devenu faux, si tu es d'accord.

Amicalement,
--
James

BoOz a écrit :

Pour ma part je suis tout à fait d'accord avec Stanislas (comme souvent, 
il faut bien le dire, Stanislas a l'oeil et le recul qui permettent de 
trouver ce qui facilite la comprehension).

Je ne sais pas quelles sont les modalités qui seraient les plus 
performantes et s'il faut exhumer la caverne au boucle et la 
bouclotheque (je serai pour à brule pour point, mais je n'y ai pas 
tellement réfléchi) mais effectivelent, spip-contrib gagnerait à avoir 
une ou deux entrée thématiques sur la page d'accueil, distinctes dans la 
présentation de celles qui y sont déjà, et présentée en tant que telles. 
(avec une couleur spéciale ou autre).

Dans le meme genre, il manque peut etre egalement une entree pour les 
tres forts en code, qui amenerai vers la doc plugin et autre doc.spip.org.

Ce dernier site est en fait un wiki (j'ai appris ca hier !!) ou l'on est 
supposé  documenter les fonctions du core de spip (si on y comprends 
qqch bien sur ^^).

BoOz

Stanislas a écrit :
  
Bonjour,

Attention, ce qui suit n'est pas un troll, c'est juste quelques réflexions 
nées à l'utilisation du forum.spip.org où je m'efforce en fonction de mes 
connaissances de répondre aux messages. Mon intention n'est donc pas de 
donner une poussée d'urticaire à quiconque, encore moins de froisser ceux 
qui oeuvrent sur spip-contrib et spip.net, nul intention de remise en cause. 
Ok ?

Donc, la répétition de certaines questions m'ont donner "envie" de voir sur 
« spip-contrib » ou « spip.net » un affichage en page d'accueil  titrant 
quelque chose comme « Les ressources pour découvrir SPIP ». Car la matière 
existe pour les débutants mais sans doute pas suffisamment fléchée et trop 
dispersée.

Dans cet esprit, je trouve dommage que la page « cavernes aux boucles » sur 
spip-contrib donne un résultat 404... pour ma part, je suis entré doucement 
dans la construction d'un squelette en faisant des copier/coller et en 
modifiant les boucles que je trouvais, notamment, dans cette rubrique jusqu'à 
pouvoir m'en affranchir et à en créer une en partant de zéro. Quand on a pas 
un bagage de programmeur, la bouclothèque permet d'obtenir un résultat 
rapidement et de faire ses classes... :-)

Comme une part des messages des forums portent sur des cas de figure, des 
applications des boucles... une bouclothèque permettrait d'offrir de 
multiples exemples concrets d'utilisation face à un manuel de référence vécu 
parfois comme trop aride parce que trop théorique (et c'est normal)  ou 
alors, parfois on comprend ce que dit le manuel, mais on ne visualise pas l'application 
et donc le bénéfice que l'on peut en tirer. Une bouclothèque est un espace à 
vocation pédagogique, à la différence d'une rubrique de contrib' ou de 
plugin qui ajoute quelque chose au script pour faire avancer la 
communauté...

Concrètement, une approche profil débutant, c'est mettre en avant une page 
"sommaire" avec un minimum d'habillage... comme celle-ci qu'il faudrait 
mettre à jour... 

A vous lire,

Cordialement

Stanislas

    

_______________________________________________
liste spip
 - désabonnement : 
Infos et archives : 
Documentation de SPIP : 
irc://irc.freenode.net/spip
FAQ : 

  

OK ! cela serai cool !!

Je profite de cet échange pour rappeler quelques éléments sur SPIP-Contrib actuel, c'est un peu long pour un mail. En fait il y a la du maériaux pour un article à faire.

Le 6 oct. 07, à 14:51, James a écrit :

BoOz a écrit :
Je ne sais pas quelles sont les modalités qui seraient les plus
performantes et s'il faut exhumer la caverne au boucle et la
bouclotheque (je serai pour à brule pour point, mais je n'y ai pas
tellement réfléchi)

Pour avoir passé beaucoup de temps à les trier je peux témoigner que les rubriques "caverne aux boucles" et"bouclotheque" de SPIP V1.5 était le parfait exemple d'un trou noir dans laquelle s'entassait (de mémoire) plus de 150 contribs sans rapports évidents entre elles, et qui parfois parlait aussi de tout autre chose que des boucles. Par ailleurs cette terminologie, aussi jolie soit-elle, n'exprime pas grand chose pour le lecteur, et relève du "divers" en fait.

Ce type d'arborescence par "moyens techniques utilisés" (variables selon les modes de chaque époque), qui était une des strates de SPIP-Contrib précédement, à déjà fait les preuves de la confusion qu'elle entraînait. Ainsi, à titre d'exemples, des contribs au cours de leur vie on d'abord été des filtres, puis sont devenues des plugins, en servant à générer de nouvelles balises à insérer dans des structures de boucles particulières, sans compter parfois l'implication de modèles, themes, etc ... comment créer une arborescence cohérente et stable sur le critère de la technique de code employée dans ces conditions ?

Dans SPIP, un article ne peut être physiquement que dans une et une seule rubrique. Il n'y a rien de pire que de vouloir gérer une telle arborescence en prétendant y inclure plusieurs critères contradictoires, ou encore de faire bouger celle-ci selon les modes du moment. Par contre il est possible d'affecter plusieurs mots clefs à chaque article (du moment que quelqu'un se tape le boulot, inclus de manière rétroactive par soucis de cohérence).

je rappelle donc les critères actuels d'organisation de SPIP-Contrib :

1) arborescence "physique" selon la finalité d'usage de la contrib, ce qui est un critère fondamental pour l'utilisateur qui vient d'abord chercher des fonctionnalités, peut importe les moyens techniques de code utilisés dans celle-ci.

2) tout ce qui concerne une contrib, et une seule, y compris son historique, les liens associés (la zone, le carnet de note, les sites extérieurs associés, tout ce qui sera imaginé, etc ..), est groupé dans une, et une seule, rubrique-dossier spécifique à cette contrib. A ce sujet l'organisation actuelle du multilinguisme (1 langue = 1 secteur) qui amène à disperser les traductions d'articles d'une même contrib n'est pas cohérente et devra évoluer.

3) mots clefs pour des navigations transversales , en sachant que pour que cela soit efficace c'est un effort constant que de les poser de manière pertinente.

Donc des mots clefs à rajouter pourquoi pas, un retour en arrière à des éléments d'arborescences aléatoires façon ancien SPIP-Contrib certainement pas.

mais effectivelent, spip-contrib gagnerait à avoir
une ou deux entrée thématiques sur la page d'accueil, distinctes dans la
présentation de celles qui y sont déjà, et présentée en tant que telles.
(avec une couleur spéciale ou autre).

une entrée spécifique pourquoi pas, cf. plus haut ... mais pourquoi une couleur spécifique sur ce sujet plus qu'un autre ? Peut-être tout simplement des mots clefs spécifiques pour quelques "parcours" spécifiques, ou tout simplement un lien sur une page récapitulative ?

Il y a peut-être encore de la place dans le bandeau entre le lien du
"glossaire" et les liens "téléchargement" et "plugin zone"

Ce bandeau est visible sur toutes les pages du site, il doit présenter des liens sur des infos génériques utiles dans toutes ces pages. Ce n'est pas le cas pour des liens "débutants".

Une bouclothèque et des tutoriaux faciles à trouver, c'est une bonne idée.

Améliorer l'accès est toujours souhaitable. Mais la question est qu'il existe déjà des choses en page sommaire :
- "http://www.spip-contrib.net/Boucles"
- "Résultats de la recherche - SPIP-Contrib; (c'est long mais ça marche)

et aussi une rubrique dédie aux squelettes qui parle de ça : "http://www.spip-contrib.net/Tutoriaux-pour-squelettes" dans "http://www.spip-contrib.net/Outils-pour-squelettes" (accessible en 2 clics depuis le sommaire)

L'autre constat pratique est que les mot clefs par profils, dont "http://www.spip-contrib.net/Debutant", pourtant disponibles depuis longtemps ne sont pas mis en oeuvre de manière fiable par les contributeurs ou les webmasters. Il y a manifestement un probleme de mise en oeuvre avec ce genre de tagg. Ce qui m'a amené à ne pas les mettre en exergue sur la page sommaire (car résultats peu probants).

Qu'est ce qu'il manque ? ... peut-etre peut on chercher les moyens d'améliorer ce qui existe déjà avant de refaire un truc de plus. Ne pas oublier la question des ressources disponibles pour se taper le boulot.

Dans le meme genre, il manque peut etre egalement une entree pour les
tres forts en code, qui amenerai vers la doc plugin et autre doc.spip.org.

J'en suis moins sur

ben voila, c'est tout le probleme de ce genre d'approche par "profils" c'est que l'on peut imaginer de multitudes de variantes

au fait c'est quoi un "débutant" .. cela concerne les compétences dans quels domaines ... comment l'utilisateur se percoit-il par rapport à ce qualificatif ?

Stanislas a écrit :

Bonjour,
Donc, la répétition de certaines questions m'ont donner "envie" de voir sur
« spip-contrib » ou « spip.net » un affichage en page d'accueil titrant
quelque chose comme « Les ressources pour découvrir SPIP ». Car la matière
existe pour les débutants mais sans doute pas suffisamment fléchée et trop
dispersée.

Oui effectivement, plus que de la nouvelle doc (qui existe la plupart du temps), ce sont des clefs pour se l'approprier qui manquent

La difficulté est que cela à déjà été tenté, mais que faute de maintenance beaucoup d'articles on dut être passé en archives. Voir par exemple la rubrique "http://www.spip-contrib.net/FAQ-Les-questions-frequentes", qui a du être passé en bloc en archives faute de force pour la mise à jour, car risquer d'enferrer des débutants par de la doc obsolète est particulièrement contre-productif. Rien n'interdit à qui le veut d'aller y faire les mises à jour nécessaires.

Dans cet esprit, je trouve dommage que la page « cavernes aux boucles » sur
spip-contrib donne un résultat 404...

Et pour cause, elle a été supprimée pour cause d'obsolescence, voire explications plus haut.

pour ma part, je suis entré doucement
dans la construction d'un squelette en faisant des copier/coller et en
modifiant les boucles que je trouvais, notamment, dans cette rubrique jusqu'à
pouvoir m'en affranchir et à en créer une en partant de zéro. Quand on a pas
un bagage de programmeur, la bouclothèque permet d'obtenir un résultat
rapidement et de faire ses classes... :slight_smile:

Nous avons tous fait cela, mais encore une fois tout existe déjà ... voir les liens plus hauts. Et dans ton approche il me parait plus pertinent, y compris dans une approche "débutant" de naviguer par rapport au fonctions que tu veux traiter : selon les cas tu retomberas sur tes boucles lorsque c'est pertinent, ou sur d'autres techniques lorsqu'elles sont plus adaptées. Cela t'enlève le souci justement de sélectionner la technique, ou le mélange de techniques, nécessaire.

Tu serais disponible pour t'en occuper et décharger un peu NicolasR ? Se
serait pas mal d'avoir des administrateurs "spécialisés" non ?

Je pense plutôt que le boulot fondamental des administrateurs rédactionnels de Contrib est plutot de conserver une vue d'ensemble pour essayer de garder un peu d'ordre dans ce bazar (balayer, ranger les étagères, mettre des étiquettes, réparer les étagères, poser des panneaux indicateurs, faire un peu de corrections dans les textes, exiger un minimum qualitatif avant publication, bref un travail de bibliothécaire) ... enfin tout apport est le bienvenu, les forums privés sont un bon support pour démarrer.

Concrètement, une approche profil débutant, c'est mettre en avant une page
"sommaire" avec un minimum d'habillage.

J'ai rien compris .. ou plutot si je crois deviner. Je pense qu'au contraire le "débutant" (en admettant que l'on arrive à qualifier un tel état provisoire et variable selon le sujets) doit d'emblée pouvoir visualiser qu'il y a plein de choses possibles, même si cela ne lui est pas accessible de suite. C'est cela qui va le motiver à progresser, et non l'enfermement dans une information artificiellement appauvrie. Je crois les lecteurs sont très rapidement capable de comprendre si une contrib est pour eux ou pas, pour peu que l'article soit suffisamment explicite (cela fait parti des critères de validation)

.. comme celle-ci qu'il faudrait
mettre à jour... http://www.spip-contrib.net/SPIP-par-le-debut

bin voila, c'est tout le probleme que ce genre de page demande de la maintenance en permanence, il faut donc que des auteurs s'y collent. La du coup j'ai voulu commencer à un peu la nettoyer et j'ai renoncé devant l'importance du travail. Ne pas hésiter à proposer une variante remise au goût du jour, par exemple en utilisant les outils de traductions pour faire une copie de l'article à modifier ensuite.

Même si je suis d'accord et qu'il faudra modifier le texte, tu peux
commencer par mettre des commentaires sur ce qu'il manque ou ce qui est
devenu faux, si tu es d'accord.

absolument

<nicolasriq <at> free.fr> writes:

>> BoOz a écrit :
>> Je ne sais pas s'il faut exhumer la caverne au boucle et la
>> bouclotheque

Pour avoir passé beaucoup de temps à les trier je peux témoigner que
les rubriques "caverne aux boucles" et"bouclotheque" de SPIP V1.5 était
le parfait exemple d'un trou noir dans laquelle s'entassait (de
mémoire) plus de 150 contribs sans rapports évidents entre elles

Oui, mais cela ne condamne pas l'idée, comme toujours le plus difficile est de
maintenir une ligne éditoriale... Et puis, en y réfléchissant spip.net a une
rubrique qui ressemble à une bouclothèque :
Quelques exemples de boucles - SPIP et ce serait d'ailleurs sans doute plus
logique de continuer à travailler la question sur ce site.

3) mots clefs pour des navigations transversales , en sachant que pour
que cela soit efficace c'est un effort constant que de les poser de
manière pertinente.

Oui, et il y a un manque, c'est de pouvoir en sélectionner plusieurs. Lorsque
l'on cherche quelque chose, on aimerait choisir par exemple
"plugin"+"1.9.2"+"administration" . Car comme on ne peut en choisir qu'un seul,
on a le sentiment d'avoir beaucoup de réponses non pertinentes dans la liste.

> Il y a peut-être encore de la place dans le bandeau entre le lien du
> "glossaire" et les liens "téléchargement" et "plugin zone"
Ce bandeau est visible sur toutes les pages du site, il doit présenter
des liens sur des infos génériques utiles dans toutes ces pages. Ce
n'est pas le cas pour des liens "débutants".

oui, je pensais plutôt à un visuel très "tape à l'oeil" pour être incontournable
par les nouveaux arrivants. Mon idée tournait autour d'un slogan du type « Les
ressources pour découvrir SPIP ». Le terme "débutant" n'est pas clair, j'en suis
le premier d'accord. En fait, sur spip-forum il y a 2 grands types de
"découvreurs", ceux qui débutent dans la publication sur le net (en l'occurrence
avec spip) et les pros du net (ou les avertis) qui débutent avec spip... il y a
un tronc commun qui pourrait se trouver derrière le lien que je suggère mais
évidemment les chemins divergent rapidement ensuite...

> Une bouclothèque et des tutoriaux faciles à trouver, c'est une bonne
> idée.
Améliorer l'accès est toujours souhaitable. Mais la question est qu'il
existe déjà des choses en page sommaire :
- "http://www.spip-contrib.net/Boucles&quot;

Oui, la matière existe, aucun doute, ce qui ne fonctionne pas c'est l'adéquation
entre les différents endroits où se trouve l'info ou les chemins d'accès et la
démarche d'une personne qui recherche cette info.

Moi, je suis encore en découverte sur des fonctionnalités de spip. Par exemple,
si je veux me documenter sur la balise ENV forcément je me reporte d'abord au
manuel de spip.net, or des articles très intéressants existent sur
spip-contrib... et pas de lien à partir de spip.net.

Je mets de côté la démarche de passer par un moteur de recherche du net qui de
toute façon a elle aussi ses faiblesses (tapez ENV et vous m'en direz des
nouvelles...). Il va falloir passer du temps (trop au goût de certains) à sérier
les mots clés les plus pertinents (tous seront ils faire ?).

Et par ailleurs, plus subtile que la compréhension d'une fonctionnalité, c'est
de comprendre l'apport que peut avoir l'emploi d'une fonctionnalité ou encore
plus subtile, avec quelles autres fonctionnalités la marier pour ouvrir encore
d'autres perspectives...

C'est là où, pour revenir à mon histoire de démarche de l'utilisateur dans sa
quête d'info, à la limite, le manuel de référence devrait être pourvu d'un lien
"exemples" à côté de chaque fonction qui propulse sur des pages de type
bouclothèque ou tuto d'un cas concret.

Qu'est ce qu'il manque ? ... peut-etre peut on chercher les moyens
d'améliorer ce qui existe déjà avant de refaire un truc de plus. Ne pas
oublier la question des ressources disponibles pour se taper le boulot.

....

enfin tout apport est le bienvenu, les forums privés sont un bon support pour
démarrer.

Chez Framasoft aussi ils ont eu à se pencher sur ce problème des bonnes volontés
disponibles. Pourquoi ne pas reprendre l'initiative sous la forme que l'on
voudra de s'appuyer sur la centaine de lecteurs quotidien de spip.net et
spip.contrib pour formaliser le signalement d'une mise à jour ou d'une
modification à apporter ?

Perso, j'ai signaler ici Insérer des formules mathématiques en LaTEX - SPIP dans le forum
privé que le lien du dernier paragraphe était brisé (ce qui m'a inspiré cette
réflexion là :
Discuter chez rezo.net

J'ai également fait un signalement dans le forum privé de cet article là :

Car la

>>> matière
>>> existe pour les débutants mais sans doute pas suffisamment fléchée
>>> et trop
>>> dispersée.

Oui effectivement, plus que de la nouvelle doc (qui existe la plupart
du temps), ce sont des clefs pour se l'approprier qui manquent

Oui, en fait c'est un peu ce que cherche aussi les journalistes... :slight_smile:

La difficulté est que cela à déjà été tenté, mais que faute de
maintenance beaucoup d'articles on dut être passé en archives. Voir par
exemple la rubrique
"http://www.spip-contrib.net/FAQ-Les-questions-frequentes&quot;, qui a du
être passé en bloc en archives faute de force pour la mise à jour, car
risquer d'enferrer des débutants par de la doc obsolète est
particulièrement contre-productif. Rien n'interdit à qui le veut
d'aller y faire les mises à jour nécessaires.

C'est vrai... et en même temps un cms comme spip sans faq et toutes ces
questions récurrentes sur les forums... à ce propos, l'organisation de
spip-forum pourrait aussi être un peu retouchée en conséquence...

Et dans ton approche il me parait plus
pertinent, y compris dans une approche "débutant" de naviguer par
rapport au fonctions que tu veux traiter : selon les cas tu retomberas
sur tes boucles lorsque c'est pertinent, ou sur d'autres techniques
lorsqu'elles sont plus adaptées. Cela t'enlève le souci justement de
sélectionner la technique, ou le mélange de techniques, nécessaire.

Oui, comme je le disais, c'est le besoin que l'on ressent en lisant le manuel de
référence sur spip.net, un lien qui permette d'aller vers les pages (elles
existent) qui approfondissent et/ou explicitent une fonction.

> Tu serais disponible pour t'en occuper et décharger un peu NicolasR ?
> Se
> serait pas mal d'avoir des administrateurs "spécialisés" non ?

Je pense plutôt que le boulot fondamental des administrateurs
rédactionnels de Contrib est plutot de conserver une vue d'ensemble
pour essayer de garder un peu d'ordre dans ce bazar (balayer, ranger
les étagères, mettre des étiquettes, réparer les étagères, poser des
panneaux indicateurs, faire un peu de corrections dans les textes,
exiger un minimum qualitatif avant publication, bref un travail de
bibliothécaire) ...

Oui, s'il fallait mettre en oeuvre l'idée que je viens d'exprimer ci-dessus
c'est tout à fait cela. Et si les lecteurs pouvaient eux-mêmes très très
facilement (cad à partir de l'interface public) suggérer une liaison... d'autant
qu'il me semble qu'à la différence des lecteurs de Framasoft que je citais plus
haut, les lecteurs de spip se sentent beaucoup plus concernés par le fait que la
doc soit le mieux foutu possible...

>>> Concrètement, une approche profil débutant, c'est mettre en avant
>>> une page
>>> "sommaire" avec un minimum d'habillage.

J'ai rien compris .. ou plutot si je crois deviner. Je pense qu'au
contraire le "débutant" (en admettant que l'on arrive à qualifier un
tel état provisoire et variable selon le sujets) doit d'emblée pouvoir
visualiser qu'il y a plein de choses possibles, même si cela ne lui est
pas accessible de suite. C'est cela qui va le motiver à progresser, et
non l'enfermement dans une information artificiellement appauvrie. Je
crois les lecteurs sont très rapidement capable de comprendre si une
contrib est pour eux ou pas, pour peu que l'article soit suffisamment
explicite (cela fait parti des critères de validation)

En fait, la page "SPIP-par-le-debut" ne me sied pas vraiment, je l'ai citée
parce qu'elle voulait répondre aux questions fondamentales et qui n'apparaissent
pas toujours clairement de prime abord au lecteur : à quoi ça sert, pourquoi
c'est comme cela, comment ça marche, etc...

Car bien sûr, on fini par s'y retrouver dans la galaxie spip ou on arrive à
raccrocher un plugin ou une contrib à une fonction et à comprendre l'intérêt et
l'utilisation qui peut en être fait... le besoin (je pense) est qu'il faudrait
essayer de raccourcir ce temps d'appropriation de la doc.

Cela me fait bondir parfois de lire que la doc de spip est faible alors qu' à
mes yeux c'est un cms parmi les plus documentés... et je crois que c'est le
foisonnement qui pèche parce que l'on en comprend pas immédiatement le but et
l'origine des multiples initiatives... untel pensera que telle doc est obsolète
parce qu'il va rencontrer une syntaxe qui a vieilli alors que tout est bon et
qu'il suffit d'appliquer avec la syntaxe nouvelle...

Pour contrer cela, je crois qu'il faut flécher en très très gros un endroit où
l'on va expliquer le pourquoi des choses. Un endroit incontournable et unique.
Exemple : pour répondre à l'arrivée de la nouvelle écriture des url, chaque doc
de spip.net explique comment se faisait l'ancienne syntaxe... pourquoi ne pas
faire un seul article sur le sujet et renvoyé dessus ?

A vous lire encore, vos réflexions m'en inspirant aussi... :slight_smile:

Amicalement
Stanislas

Stanislas a écrit :

<nicolasriq <at> free.fr> writes:

BoOz a écrit :
Je ne sais pas s'il faut exhumer la caverne au boucle et la
bouclotheque
        

Pour avoir passé beaucoup de temps à les trier je peux témoigner que les rubriques "caverne aux boucles" et"bouclotheque" de SPIP V1.5 était le parfait exemple d'un trou noir dans laquelle s'entassait (de mémoire) plus de 150 contribs sans rapports évidents entre elles
    
Oui, mais cela ne condamne pas l'idée, comme toujours le plus difficile est de maintenir une ligne éditoriale... Et puis, en y réfléchissant spip.net a une
rubrique qui ressemble à une bouclothèque :
Quelques exemples de boucles - SPIP et ce serait d'ailleurs sans doute plus
logique de continuer à travailler la question sur ce site.

3) mots clefs pour des navigations transversales , en sachant que pour que cela soit efficace c'est un effort constant que de les poser de manière pertinente.
    
Oui, et il y a un manque, c'est de pouvoir en sélectionner plusieurs. Lorsque
l'on cherche quelque chose, on aimerait choisir par exemple
"plugin"+"1.9.2"+"administration" . Car comme on ne peut en choisir qu'un seul,
on a le sentiment d'avoir beaucoup de réponses non pertinentes dans la liste.

Il y a peut-être encore de la place dans le bandeau entre le lien du
"glossaire" et les liens "téléchargement" et "plugin zone"
      

Ce bandeau est visible sur toutes les pages du site, il doit présenter des liens sur des infos génériques utiles dans toutes ces pages. Ce n'est pas le cas pour des liens "débutants".
    
oui, je pensais plutôt à un visuel très "tape à l'oeil" pour être incontournable
par les nouveaux arrivants. Mon idée tournait autour d'un slogan du type « Les
ressources pour découvrir SPIP ». Le terme "débutant" n'est pas clair, j'en suis
le premier d'accord. En fait, sur spip-forum il y a 2 grands types de
"découvreurs", ceux qui débutent dans la publication sur le net (en l'occurrence
avec spip) et les pros du net (ou les avertis) qui débutent avec spip... il y a
un tronc commun qui pourrait se trouver derrière le lien que je suggère mais
évidemment les chemins divergent rapidement ensuite...

Une bouclothèque et des tutoriaux faciles à trouver, c'est une bonne idée.
      

Améliorer l'accès est toujours souhaitable. Mais la question est qu'il existe déjà des choses en page sommaire :
- "http://www.spip-contrib.net/Boucles&quot;
    
Oui, la matière existe, aucun doute, ce qui ne fonctionne pas c'est l'adéquation
entre les différents endroits où se trouve l'info ou les chemins d'accès et la
démarche d'une personne qui recherche cette info.

Moi, je suis encore en découverte sur des fonctionnalités de spip. Par exemple,
si je veux me documenter sur la balise ENV forcément je me reporte d'abord au
manuel de spip.net, or des articles très intéressants existent sur
spip-contrib... et pas de lien à partir de spip.net.

Je mets de côté la démarche de passer par un moteur de recherche du net qui de
toute façon a elle aussi ses faiblesses (tapez ENV et vous m'en direz des
nouvelles...). Il va falloir passer du temps (trop au goût de certains) à sérier
les mots clés les plus pertinents (tous seront ils faire ?).

Et par ailleurs, plus subtile que la compréhension d'une fonctionnalité, c'est
de comprendre l'apport que peut avoir l'emploi d'une fonctionnalité ou encore
plus subtile, avec quelles autres fonctionnalités la marier pour ouvrir encore
d'autres perspectives...

C'est là où, pour revenir à mon histoire de démarche de l'utilisateur dans sa
quête d'info, à la limite, le manuel de référence devrait être pourvu d'un lien
"exemples" à côté de chaque fonction qui propulse sur des pages de type
bouclothèque ou tuto d'un cas concret.

Qu'est ce qu'il manque ? ... peut-etre peut on chercher les moyens d'améliorer ce qui existe déjà avant de refaire un truc de plus. Ne pas oublier la question des ressources disponibles pour se taper le boulot.
    

....
  

enfin tout apport est le bienvenu, les forums privés sont un bon support pour
démarrer.
    
Chez Framasoft aussi ils ont eu à se pencher sur ce problème des bonnes volontés
disponibles. Pourquoi ne pas reprendre l'initiative sous la forme que l'on
voudra de s'appuyer sur la centaine de lecteurs quotidien de spip.net et
spip.contrib pour formaliser le signalement d'une mise à jour ou d'une
modification à apporter ?

Perso, j'ai signaler ici Insérer des formules mathématiques en LaTEX - SPIP dans le forum
privé que le lien du dernier paragraphe était brisé (ce qui m'a inspiré cette
réflexion là :
Discuter chez rezo.net

J'ai également fait un signalement dans le forum privé de cet article là :
Mon premier squelette - SPIP

Car la
        

matière
existe pour les débutants mais sans doute pas suffisamment fléchée et trop
dispersée.
          

Oui effectivement, plus que de la nouvelle doc (qui existe la plupart du temps), ce sont des clefs pour se l'approprier qui manquent
    
Oui, en fait c'est un peu ce que cherche aussi les journalistes... :slight_smile:

La difficulté est que cela à déjà été tenté, mais que faute de maintenance beaucoup d'articles on dut être passé en archives. Voir par exemple la rubrique "http://www.spip-contrib.net/FAQ-Les-questions-frequentes&quot;, qui a du être passé en bloc en archives faute de force pour la mise à jour, car risquer d'enferrer des débutants par de la doc obsolète est particulièrement contre-productif. Rien n'interdit à qui le veut d'aller y faire les mises à jour nécessaires.
    
C'est vrai... et en même temps un cms comme spip sans faq et toutes ces
questions récurrentes sur les forums... à ce propos, l'organisation de
spip-forum pourrait aussi être un peu retouchée en conséquence...

Et dans ton approche il me parait plus pertinent, y compris dans une approche "débutant" de naviguer par rapport au fonctions que tu veux traiter : selon les cas tu retomberas sur tes boucles lorsque c'est pertinent, ou sur d'autres techniques lorsqu'elles sont plus adaptées. Cela t'enlève le souci justement de sélectionner la technique, ou le mélange de techniques, nécessaire.
    
Oui, comme je le disais, c'est le besoin que l'on ressent en lisant le manuel de
référence sur spip.net, un lien qui permette d'aller vers les pages (elles
existent) qui approfondissent et/ou explicitent une fonction.

Tu serais disponible pour t'en occuper et décharger un peu NicolasR ? Se
serait pas mal d'avoir des administrateurs "spécialisés" non ?
      

Je pense plutôt que le boulot fondamental des administrateurs rédactionnels de Contrib est plutot de conserver une vue d'ensemble pour essayer de garder un peu d'ordre dans ce bazar (balayer, ranger les étagères, mettre des étiquettes, réparer les étagères, poser des panneaux indicateurs, faire un peu de corrections dans les textes, exiger un minimum qualitatif avant publication, bref un travail de bibliothécaire) ...
    
Oui, s'il fallait mettre en oeuvre l'idée que je viens d'exprimer ci-dessus
c'est tout à fait cela. Et si les lecteurs pouvaient eux-mêmes très très
facilement (cad à partir de l'interface public) suggérer une liaison... d'autant
qu'il me semble qu'à la différence des lecteurs de Framasoft que je citais plus
haut, les lecteurs de spip se sentent beaucoup plus concernés par le fait que la
doc soit le mieux foutu possible...

Concrètement, une approche profil débutant, c'est mettre en avant une page
"sommaire" avec un minimum d'habillage.
          

J'ai rien compris .. ou plutot si je crois deviner. Je pense qu'au contraire le "débutant" (en admettant que l'on arrive à qualifier un tel état provisoire et variable selon le sujets) doit d'emblée pouvoir visualiser qu'il y a plein de choses possibles, même si cela ne lui est pas accessible de suite. C'est cela qui va le motiver à progresser, et non l'enfermement dans une information artificiellement appauvrie. Je crois les lecteurs sont très rapidement capable de comprendre si une contrib est pour eux ou pas, pour peu que l'article soit suffisamment explicite (cela fait parti des critères de validation)
    
En fait, la page "SPIP-par-le-debut" ne me sied pas vraiment, je l'ai citée
parce qu'elle voulait répondre aux questions fondamentales et qui n'apparaissent
pas toujours clairement de prime abord au lecteur : à quoi ça sert, pourquoi
c'est comme cela, comment ça marche, etc...

Car bien sûr, on fini par s'y retrouver dans la galaxie spip ou on arrive à
raccrocher un plugin ou une contrib à une fonction et à comprendre l'intérêt et
l'utilisation qui peut en être fait... le besoin (je pense) est qu'il faudrait
essayer de raccourcir ce temps d'appropriation de la doc.

Cela me fait bondir parfois de lire que la doc de spip est faible alors qu' à
mes yeux c'est un cms parmi les plus documentés... et je crois que c'est le
foisonnement qui pèche parce que l'on en comprend pas immédiatement le but et
l'origine des multiples initiatives... untel pensera que telle doc est obsolète
parce qu'il va rencontrer une syntaxe qui a vieilli alors que tout est bon et
qu'il suffit d'appliquer avec la syntaxe nouvelle...

Pour contrer cela, je crois qu'il faut flécher en très très gros un endroit où
l'on va expliquer le pourquoi des choses. Un endroit incontournable et unique.
Exemple : pour répondre à l'arrivée de la nouvelle écriture des url, chaque doc
de spip.net explique comment se faisait l'ancienne syntaxe... pourquoi ne pas
faire un seul article sur le sujet et renvoyé dessus ?

A vous lire encore, vos réflexions m'en inspirant aussi... :slight_smile:

Amicalement
Stanislas

___________________________________________
  

Pas le courage de tout lire et pourtant je suis certain que c'est très interessant. Mais dans les grandes lignes, si j'ai bien compris, il s'agirait de supprimer comme ça purement et simplement des contribs venu de la première version de spip car elles sont obsolètes?
Et l'archivage?Comme beaucoup de choses, j'en parle en connaissance de cause étant éditeur moi même et conservateur du patrimoine, je pense que Spip vit véritablement et que sont passé est sa mémoire..Alors de grâce, ne tuez pas des contributions issues d'une passion et d'un mélange de collaboration et d'amitié. Moi je verrais bien au contraire un spip musée ( un nouveau site) , donc très facile d'accès, ou l'on se promenerait de galeries en galeries, de telechargement en telechargements de la plus vieilles versions à nos jours..
Bref pas un site spip trop technique dans l'architecture et le squelettes un peu moins froid que ceux presentés jusqu'à présent..

Et que diriez vous d'un dimanche de Spipeur qui s'en va se promener au musée spip en se disant:
Tiens aujourd'hui, je regarde les contrib de' la version 1.

Petit à petit, notre ami spipeur ou non spipeur d'ailleurs en vient à aujourd'hui en comprenant tout le cheminement de la l;ogique SPIP!

Mieux!!
Il ne posera plus les question redondantes du style. Ouinnn j'ai besoin d'un wysiwyg ou d'un retour charoit!! Bref, le dictaticiel tout en douceur et agréable.. Avec bien entendu des images, photos et vidéos on est dans un musée!! Nan, là je rigole!!!

Bonne soirée

Quo Libris

Le Mon, 08 Oct 2007 16:08:44 +0000, Stanislas a écrit :

C'est là où, pour revenir à mon histoire de démarche de l'utilisateur dans sa
quête d'info, à la limite, le manuel de référence devrait être pourvu d'un lien
"exemples" à côté de chaque fonction qui propulse sur des pages de type
bouclothèque ou tuto d'un cas concret.

Pour illustration voir http://forum.spip.org/fr_197278.html#forum197304

Stanislas