3 - Le site : philosophie, organisation, problèmes...

Salut tout le monde.

Désolé, du fait de la panne de notif mail, je n'ai pas suivis le fil précédent (v1).
J'ai organisé donc le portail tuto sans l'avoir lu, c'est une coïncidence.. donc désolé, remarques bienvenu tout ça.


Donc j'y répond ici:

Tout a fait d'accord pour le tuto.
Sauf que article, c'est un article, et une page wiki, c'est une page de la doc.
N'as tu pas fait une confusion entre les deux?
J'ai moi même mis un moment a comprendre ce qu'est un article, car plus personne n'en écris.. (je ne m'en plein pas, c'est la doc qui m’intéresse, mais c'est toujours mieux quand le site est "vivant")



oui oui oui!


REMARQUE GÉNÉRALE:
On a enfin aujourd'hui un réel outil d'organisation (il été temps!).
Et aussi une base fondamentale. De celle ci découle naturellement une structure, en écoutant son bon sens et en assumant de faire des choix.
Donc passons à l'action, je trouve vraiment qu'il y a bien trop à faire pour pouvoir parler de tout, l’essentiel été d'avoir la base et elle est là.
Donc, allez y faites! organisez! ce sera toujours plus facile de reprendre cela si jamais on le décide, plutôt que de discuter sur chaque possibilités, car il y en a plusieurs, mais aussi beaucoup à faire.. bref, vous m'avez compris, allez y!

Merci pour les remarques!

@allany: donc, à propos de tes remarques sur le précédent fil, c'est bon? tout à été remis en ordre?
Je ne sui spas d'accord que "ce n'est pas bien grave", tout les choses méritent d'etre mise à leur place! Plus tout est organisé, plus il et facile de maintenir et poursuivre l'organisation!

Les Articles sont Les Nouvelles donc une fonction indépendante du wiki

• Pour le portail des tutos

La liste des tutos risque de s'allonger et de rendre impraticable l'accès et je pense préférable de supprimer les liens directes sur les tutos et de ne garder que les 5 pages principales

Voici la capture sauf qu'elle n'est pas dans la bonne galerie.
J'ai déjà réussi à la mettre en vignette, faut pas trop en demander, hien !...



A+

D'accord Pour lkes petite résolution d'écran il faudra raccourcir le titre

Non seulement elle n(est pas dans la bonne galerie et tu n'est pas sur le bon fil
tiki-view_forum_thread.php?comments_parentId=43504&topics_offset=10

(Je te déplace la capture )

Salut tout le monde !

Moi non plus, je n'ai pas eu le temps de répondre au premier fil, et il y en a à redire
Pour commencer, dans ces cas là, merci de mettre un lien sur le fil précédent dans le premier message, ça facilite grandement le suivit. Le lien en question : Orga doc suggestions/évolution (v1).

Alors dans l'ordre :

+1 pour la création de pages séparant la liste des tutos, c'est une idée qui traine depuis longtemps (bien que pas exactement avec ce système de classification mais pourquoi pas).
Par contre l'idée n'est pas de simplifier le menu, car les tutos ne doivent pas nécessairement apparaitre dans le menu "portail tuto", je vais y revenir.


J'admet que la classification peut paraitre parfois mystérieuse, voir -n'ayons pas peur des mots- bordélique. Cependant il ne faut pas se leurer, avec un tel nombre de pages elle le sera toujours, quel que soit le modèle choisi. Je ne connais pas de site de cette ampleur qui se repose seulement sur un système de menus, à partir de plusieurs centaines de pages on passe à la méthode de recherche par mots-clef ça reste le plus pratique. C'est d'ailleur le fait que le moteur de recherche n'était pas convainquant qui m'a poussé à faire le ménage façon fil d'ariane l'année dernière (ou était-ce il y a 2 ans ?) La classification de la documentation se fait aujourd'hui beaucoup moins pressante.
En ce qui concerne les exemples sus-cités, on peut donc taper "pulseaudio" ou "behringer" dans le champ de recherche pour retrouver facilement les pages pulseaudio vers jack et Ardour 2 Et Behringer BCF.
Sans le module de recherche, on peut visiter les pages jack et pulseaudio (facilement trouvables) pour accéder à un lien sur la page visée pulseaudio vers jack, ce qui me parait tout à fait logique (c'est une vue personnelle, n'hésitez pas à me contredire si vous pensez le contraire).
La page Ardour 2 Et Behringer BCF est, il est vrai, alors difficilement accessible, mais je m'en dédouane complètement car il s'agit d'une page qui n'a pas encore été "validée par pianoliv", précision apportée par le journal des modifs.
En résumé, je trouve qu'il y a dans ce message un peu de mauvaise volonté, qui je pense ne sera pas résolue à long terme par une quelconque modification du menu.
Je rappellerai aussi qu'il existe un module de "marque-pages" dont il ne faut pas hésiter à abuser pour les pages qu'on utilise le plus souvent. Allany, combien de pages as-tu marqué ?


Là on approche le cœur du débat (comprendre, je vais en avoir pour un moment, installez-vous bien ).
Pour commencer et mettre les choses à plat, voici une petite rétrospective sur ce qu'est une documentation sur linuxmao :
Un jour un gars ou une fille s'amène et dit : "J'ai découvert ce super logiciel que je souhaite vous faire partager". Pour cela il/elle créé une page contenant pas plus qu'une image et une ligne descriptive. À ce stade on peut appeler cette page une documentation de présentation.
Puis quelqu'un découvrant la page et salivant d'envie d'essayer se bute sur des problèmes d'installation, rapidement résolus dans le forums puis transformés en un paragraphe expliquant de manière pas-à-pas comment installer le logiciel.
Une autre personne arrive, ne comprend pas comment utiliser telle ou telle fonction et rebelotte, un nouveau paragraphe est né. À ce stade la page est devenue un tutoriel décousu, contenant présentation du logiciel et explications plus ou moins précises sur certains points.
Enfin, un power-user passe par là et juge que la page manque de cohérence, ce à quoi il remédie en comblant des trous d'infos et en ajoutant des images. Le power-user étant aussi admin, et la page s'étendant maintenant sur 3km de long, il décide de la séparer en plusieurs pages selon la méthode suivante :

• page mère (introduction)
  • tuto d'installation
  • tuto telle fonction
  • détails divers

Les tutos sont alors plus ou moins complets et cohérents, il seront modifiés ou pas par la suite en fonction de la popularité du logiciel.
Et alors, qu'est-ce qu'un tuto ?
Un tuto est donc un guide, plus ou moins pas-à-pas sur l'utilisation d'une fonctionnalité. À but de vulgarisation il contient aussi une partie d'introduction généraliste. À ce titre il peut donc faire suite à une page de présentation. Il est aussi cette page de présentation elle-même à certains moments de son existance car il ne né pas forcément tuto. Il en est le complément, mais aussi le pilier, car sans lui la présentation ne résonne que comme une vielle casserole bouffée par la rouille, et sans manche.

Je crois que vous aurez compris ou je veux en venir : il n'y a virtuellement aucune différence entre une documentation et un tuto. Une page est un jour documentation et la semaine suivante tutoriel, c'est la vie du wiki.

Bon j'avoue, je vous ai raconté des bêtises. Nous dispons aussi d'un type de documentation complètement différent : les "modes d'emploi" (brrrr).
Un mode d'emploi liste et décrit les fonctionnalités d'un logiciel au complet. Je vous laisse compter combien on en a, à mon avis vos deux mains suffirons. S'il fallait différencier les pages, créer un "portail mode d'emploi" sera bien plus rapide...


Et bien j'ai envie de dire que c'est ce qui existe déjà, avec moins de rigeur il est vrai. En effet la partie tuto est souvent placée en page fille à la présentation, plutôt qu'en page-sœur, mais cela change-t-il quelque chose ?
Un exemple concret parmis bien d'autres :

• portail matériel
  • Cartes son
    • Tester sa carte son

Il s'agit là d'une vision complétement différente de la chose. Dans le système actuel (et celui proposé j'ai l'impression par allany), la base pour grouper les pages est le logiciel. Ensuite viennent les types de pages.
Ici on prend en compte les types de page d'abord, puis le logiciel ensuite, ce qui vient a l'encontre même du processus de création de tuto expliqué plus haut : avec ce système une page n'évolue plus de simple présentation en tuto, il faut complétement changer de section pour garder la continuité naturelle "présentation des objets" → "mise en pratique".


Là je ne vois même pas de quoi tu veux parler. Ou plutôt si, j'ai peur de comprendre et si c'est le cas je peux dire que c'est faux.
Par exemple la page "tuto jack premier lancement" est déjà dans la structure, dans le dossier jack. Son fil d'ariane est "Doc → Portail Logiciel → Catégorie système → Jack → Tuto Jack premier lancement ". Une fois accédée par le menu "portail tuto → débutant" on pourrai s'attendre selon ta remarque a ce que le fil devienne "Doc → portail tuto → débutant → Tuto Jack premier lancement ".
Et bien ce n'est pas le cas, et pour cause : tiki est ici configuré pour qu'une page ne puisse pas être a deux places différentes dans la même structure.
Cette configuration est voulue ainsi car cela permet d'avoir un fil d'ariane unique et par défaut : quel que soit la manière dont on accède à cette page le fil d'ariane sera présent et toujours le même.
Il est possible d'activer l'option qui permet de placer une page à plusieurs endroits d'une structure, mais la page n'a alors plus de fil par defaut, ce qui fait que si l'on clique sur un lien tel qu'ici dans le forum, aucun fil d'ariane n'apparaitra, ce qui enlève beaucoup à la cohésion globale.


Tout cela est juste, et bien que n'apportant rien au débat il faut rendre à césar ce qui lui appartient donc : bien vu !


Tu peux développer allany ?
Javoue ne pas comprendre cette remarque.


Juste, mais cela ne nécessite pas pour autant que les pages soient visibles à partir du menu. Depuis sa création le portail des tuto? sert de "rappel". Tous les liens qu'il contient sont des doublons de liens existant dans d'autres portails. Rien n'empêche de se cantonner à afficher les dossiers ("débutant", "système") dans le menu et qu'il faille cliquer dessus pour accéder aux pages qu'ils présentent comme cela était déjà le cas. Cela n'enlève en rien la justesse de la remarque qui se résume à : Il faut ajouter les tutos oubliés.


Évidemment qu'une page est intégrée à plusieurs endroits, et cela n'a rien de nouveau !
C'est peut être une des choses qui a du mal en rentrer : intégration ne signifie pas forcément hierarchie, et hierarchie ne signifie pas forcément unique point d'entrée.
L'intégration d'une documentation passe d'abord par l'ajout de liens wiki dans toutes les pages en rapport, pour que cette doc soit la plus visible et accessible possible. Le fil d'ariane et la hierarchie ne sont qu'une proposition de navigation de plus parmis tant d'autres, visant les personnes confortables à suivre les sentiers traçés et permettant de pouvoir faire demi-tour pour retourner à la chaumière avant la nuit. Mais tout le monde n'est pas un chaperon rouge heuresement, le hors-piste et le camping sauvage ont leurs vertus aussi !


Comme pour tout à l'heure, la raison est que cette page Ardour 2 La compression en sidechain n'a malheuresement pas encore été intégrée. En attendant, pense au nouveau module de recherche, il est vraiment magique ! (j'ai tappé "compresseur" pour retrouver la page).


Pour moi, c'est plutôt un bel exemple de collaboration (6 auteurs), et un magnifique exemple de mon explication de la vie d'une page wiki au dessus (elle en serai donc au stade ou il est temps de la séparer en plusieurs pages, un admin dans le coin ?)...


Essaye "side", ou "chain"...

Je n'ai épluché que la moitié du forum, mais je vais arrêter là pour ce soir.
Chapeau à qui m'aura lu, mais je suis sûr que vous aurez tous compris l'essentiel...

oliv'

Hello !

Passionnant, tout ceci !
Je note qu'une page ne peut avoir qu'un seul emplacement. Délicat, donc, pour décider de la poser à tel ou tel endroit, figeant ainsi sa localisation...

Oui, Piano', ma phrase pour laquelle tu me demandes des éclaircissements, ben elle définitivement... obscure !
Je ne comprends pas non plus ce que j'ai voulu dire...
Sinon, peut-être, qu'un tuto, outre son aspect "guide-d'installation-ou-d'utilisation-pas-à-pas" peut aussi enrichir en détails une doc plus généraliste, justifiant ainsi son rattachement "hiérarchique" à cette même doc.

Ceci dit, utilisateur_anonyme a réorganisé, depuis, les tutos et j'y retrouve maintenant très facilement mes liens pour mes réponses dans les forums.
Il faut savoir que ma pratique des forums me pousse à croire que très peu de liens sont nécessaires. "Jack premier lancement" tient la tête et est suivi de 2-3 autres dont, justement "Pulse sans MAO et MAO sans Pulse" pour cause d'Ubuntustudio largement diffusé...

A+

Oui en effet la création de l'alias est possible mais garde le fil du premier alias c'est bête.

Ce que je disait c'est qu'une méthode simple d'installation n'as pas lieu d'être scibdée en un tuto
comme par exemple Ardour 3 tellement la méthode es simple faire un tuto pour un lancer install.sh serait ....
c'est d'ailleurs comme ça que j'ai trouvé ce que allany ne trouvait pas

certes mais comparativement l'ensemble est bien plus souple ...
ET attendons la MAJ de tiki pour voir les pages accessible depuis plusieurs endroits dans les stuctures?

d'ou mon post :

le plus gros de l'orga à été faite par xzu (prennons à césar ce qui aparatient à xzu!

... merci, xzu !

C'est bien ça. Mais je ne saurai que trop insister sur le fait que la localisation indue par la structure n'est qu'une des manières de naviguer dans le wiki.


C'est bien vrai aussi. Une esquisse de solution pourrai être le portail du débutant, qui devrait (dans un monde idéal), contenir tous ces liens importants et servir ainsi de repère.
Du coup, est-ce que tu t'y retrouverai autant si les pages que tu cherches n'était pas accessibles en un clic dans le menu "portail tuto", mais en deux (dans l'hypothèse ou les liens de troisième niveau disparaissent du menu "portail tuto", et qu'il faille d'abord cliquer sur un des sous-dossiers de ce portail pour accéder au lien désiré dans la page-sous-dossier) ?


t'es sous ubuntu c'est ça ?
On peut facilement remplir une page entière avec des méthodes d'installations pour plusieurs distro...


Vrai, c'est quand même un peu plus souple.
Je suis tout à fait pour attendre une maj de tiki qui permettrai d'avoir un fil d'ariane par défaut en cas de conflit, même s'il est déjà aujourd'hui possible d'appliquer plusieurs fils d'ariane à une page si on le désire vraiment.


Je n'ai pas du arrivé jusqu'à ce post.
Je crois qu'on est tout à fait d'accord !

oliv'

ps : j'ai ré-édité mon message précédent pour corriger quelques fautes de frappe et surtout reformuler ma pique maladroite concernant allany qui m'a empéchée de dormir. Il n'y a pas de mauvaise foi en jeu, probablement juste un manque de compréhension du système du à un manque de temps à passer à le découvrir, ce que personne ne peut blâmer.

☟ mais c'est juste un peu plus haut sur la page ☝

Envoyé par utilisateur_anonyme  le mar. 16 avr. 2013 09:56

Ben oui, je me suis arrêté hier (à 1h10) au message d'allany du 7 avril.
Aller je reprend ma progression dans ce fouilli...


Pourquoi pas. Tient ça ressemble étrangement à l'orga globale de la Toute la documentation, j'ai pas du faire trop de bêtises...


Une raison de plus pour ne pas utiliser le système de structure/fil d'ariane (dont l'édition est réservée aux admins wiki) dans le portail des tutos. Si les sous-dossiers sont de simples pages de liens, tout inscrit peut en rajouter.


Pour clarification, "article" peut s'appliquer aux "nouvelles" ainsi qu'aux "pages wiki".
Ce pourquoi un effort a été fait pour généralement nommer les nouvelles en "nouvelles" et les pages wiki en "pages de documentation wiki", afin d'éviter les confusions.


Remarque pleine de bon sens. Par expérience la théorie ne s'applique pas forcément en pratique de toute façon. Il est donc généralement plus aisé de commencer à passer à l'action puis de voir ou vont les choses, par exemple en créant des sous-dossiers s'appliquant réellement aux pages qu'ils sont sensé contenir.

Enfin concernant le nommage des pages, une page de documentation wiki étant comme dit plus haut finalement la même chose qu'un tuto, il est donc en effet inutile d'apporter la mention "tuto" dans le titre.
Les règles de nommages sont déjà disponibles ici.

A toute !

oliv'

Normal les 5 pages tutos dans portail des tutos ont été créées par xzu après ce post .(hé hé!! )
D'ailleurs ce même jour on en a parlé sur irc (et aussi des vagues que le sujet aurait pu soulever)

Hé ben non, j'avais rien lu, depuis la première réponse de pianoliv, je me suis abstenu, en me disant, "oula, c'est pas le genre de fil ou je répond en deux deux!"

Mais là j'ai rien de mieux à faire et figurez vous que j'ai tout lu!! (mais seulement la version deux, attend, faut pas pousser!)

Ycollet, ne le prend pas mal, mais je crois que ta question mérite une place entière, et aussi que ce fil mérite de rester sur son sujet propre.

Et pour le fameux sujet, je suis plutôt content de la richesse de la réflexion.

Comme je l'ai déjà dit, dé-fois, les choses tombent sous le sens: un jour j'ai fait le tour de la doc, elle m'a parue assez cohérente, et cela m'a satisfait.
Puis j'ai regardé ce fameux portail tuto, et l'explorant, il m'a filé le tournis et énervé en me rappelant le vieux linuxmao.
En l’observant, une structure m'est apparue, et je l'ai appliqué, basta. après ça allait mieux, et je suis tombé sur ce fil!

Bref: je me répète, quand on voit comment, alors il faut faire.

Regardez, je doute que pianoliv avait prévu que son classement "pas très user friendly" de l'époque du portail logiciel allé donner, suite à l'upgrade, un super classement user friendly. (tu m'a vraiment bluffé sur ce coup là, c'était il y plus de deux ans mec!)
Pourtant il l'a fait, c'était un besoin (et pour moi aussi).


Pour revenir au sujet, pianoliv fait bien de s’étaler comme il vient de la faire, car il nous partage sa grande expérience.
Je doit dire que je suis bien d'accord avec lui et que je trouve ses remarques pertinante.
SAUF à propos d'un détail. à ropos de tuto≠doc.

Pour m'expliquer, je doit dire que je tire mon expérience de l'utilisation du net: trinine (mon frère et aussi ancien grand admin à qui on doit les entêtes de paragraphes en forme de notes par exemple) m'installe ubuntu 7.10 et 64 studio et trois mois plus tard je me retrouve comme un con avec ma delta44 et la première connexion internet de ma vie.
On est en 2007 donc.
Tout m'a donc été appris par internet, et une bonne part par ubuntu.fr, qui bien que bordélique, était (et est toujours) agréable, sympa et intuitif!
Un peu comme linuxmao aujourd’hui .

Mais cette expérience, loin d’être négligeable puisque qu'elle m'a fait passer d'un coté à l'autre du miroir, m'a appris une chose, qui n'est que mon avis bien sur:
il y a une vrai différence entre tutos et doc.

Bien qu'il soit liés, proches et complémentaires (c'est évident), ils on un gout, une approche, un caractère complètement différent.
Il y à certains domaines où je ne demande que du tuto,
d'autres ou je m'en branle même s'ils sont nombreux et exhaustifs et où je veux uniquement une doc: cela dépend de nombreux paramètres, très personnels et propres à chacun.

Autres chose déterminante: un tuto peu être très personnel, très imprégné de la personnalité et du point de vue de son auteur, qui peu parfois chercher uniquement à nous donner son approche d'un sujet, et avec donc son style, son vocabulaire, sa méthode.
Je trouve cela à l'opposé d'une documentation (donc complémentaire, oui), qui se doit d’être le plus neutre possible, avec la même structure pour tous, comme par exemple l’efficace fonction, image, description, installation que l'on connais de notre chère doc.

Je ne sais pas vraiment pourquoi j'insiste autant là dessus, mais j'en ressent le besoin, je me dit qu'il y à un truc à ne pas laisser passer. Pour moi l'équilibre doc/tuto et un signe de maturité. Il est aussi selon moi nécessaire de commencer par la doc, puis les tuto.
Mais la doc, regardez! Elle est là.
Donc maintenant, place au tuto, et là, ça peut vraiment être "free style".
Je crains que cette idée ne plaise pas à tout le monde, mais tout le monde n'a pas besoin d'un tuto, et si un "style" ne te plait pas et ben, pompe sur ton voisin et formule en un a ta sauce! tuto Ardour3: -selon xzu -selon duchmol -etc...

Je crois qu'avec l'outil d’aujourd’hui, on peut réussir à créer un engouement par les utilisateur à présenter leur méthodes selon leur point de vu, ce qui avouez le, et bien plus bandant que créer une page, suivre et respecter un plan, gnagna gni...

Ça c'est un point.
L'autre point et que, selon moi, linuxmao manque cruellement de tutos, j'ai pu le deviner dans de nombreuses discutions. Et ailleurs aussi.


En fait voilà! j'ai trouvé une belle image: la doc c’est le livre, et aujourd’hui on a une bibliothèque cohérente;
Le tutos c'est le prof, le cours,l'espérience personnelle (et personifiée): ceux qui on rencontrés des gens qui savent pourquoi ils donnent des cours reconnaitrons que leur enseignement et inégalable.

Cependant imaginez que des profs (de musique) sans livre: et ben on aurai beaucoup trop "d'élève de", qui jouerai "à la manière de", et sans prof avec que du livre, cela manque de vivant de caractère. C'est ce qui manque à la belle biblioteque qu'est devenun linuxmao aujourd'hui.

Les profs comme les élèves ont besoin d'une bonne bibliothèque!

Bref, cf tiki-view_forum_thread.php?comments_parentId=43893&topics_offset=2 et notamment les avis sont bienvenu sur Charte des Tutos.

Salut

En d'autre termes il faudrai une doc/structure complètement à part pour les tutoriel dans la colonne de gauche ...

Très pertinentes réflexion sur le "style" des tutos et des pages je dirai que c'est bien vu.

A propos de l'orga des tutos je sais pas ce que t'en dis xzu mais je serai d'avis que
seule la page mère des tuto comme ceux de Ardour 3 et une page mère pour Ardour 3 soit visible depuis le menu des tutos et le reste accessible depuis la page mère mais pas par le menu sinon c'est plus un écran qu'il nous faudra... (mais un mur)

Je ne vous suis pas. En dehors du débat doc≠tuto je croyais qu'on était d'accord pour ne pas afficher les tutos directement dans le menu ?
Je rappel que ces tutos sont déjà pour la plupart ailleur dans le menu doc, et que les rajouter dans le menu doc > tuto sans activer la fonction de multiples instances d'une page dans une structure fait foirer le fil d'ariane.

oliv'