Chargement...
 
[Voir/Cacher menus de gauche]
[Voir/Cacher menus de droite]

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

> Forums de discussion > 3 - Le site : philosophie, organisation, problèmes... > [FAIT] tchatche IRC du samedi 01 octobre 2011 (était "organisation de la doc")
Dernier post

[FAIT] tchatche IRC du samedi 01 octobre 2011 (était "organisation de la doc")

pianolivier utilisateur non connecté France
Salut à tous

Voilà, je vous invite tous à une petite réunion sur IRC samedi 1er octobre (oui, celui qui vient) à 18h sur #linuxmao.
Ceux qui ne connaissent pas IRC, freenode ou #linuxmao iront faire un tour sur la page explicative SITE_fonctionnement_IRC.

Le but de cette réunion : parler de l'organisation de la documentation sur le site.
Plusieurs débats ont été abordés ces derniers temps, mais on va les prendre un-par-un ok ? smile

Si ça vous interresse mais n'êtes pas disponible, vous pouvez toujours allez donner votre avis sur ce sujet du forum ou ici-même.

Si vous êtes dispo, vous pouvez preparez vos questions/remarques et lire ce même sujet du forum en guise d'intro. Merci de faire savoir si vous comptez participer afin que l'on attende tout le monde avant de commencer.

à samedi !

oliv' aka pianolivier

pianolivier utilisateur non connecté France
Compte rendu de la réunion du 1er octobre 2011 sur #linuxmao

présents : pianolivier, Flo, ycollet, et en spectateur arrivé un peu plus tard : jmpc
ordre du jour :
  • proposition de règles de nommage des pages wiki
  • proposition de plan des pages wiki

La réunion commence à l'heure (18h)

Pianolivier propose de redéfinir les régles de nommage des pages (et des alias), Flo approuve.
Le principe est d'uniformiser le wiki, mais aussi d'obtenir un meilleur affichage (et peut-être rank) et des recherches plus efficaces chez google et consorts.
Pianolivier commence par expliquer ce que sont les alias, ce sont des bouts de code insérés dans une page wiki qui permettent de créer des redirections d'URL sur le site, et donc d'accèder à une page par une adresse http alternative. Il explique qu'une chose s'opposait au renommage de pages précédemment, c'est qu'il faut que les anciennes URL restent valides (pour ne pas casser les liens qui peuvent exister sur le net) et aucune fonction de tiki ne permettait cela facilement avec l'ancienne version. Avec les alias, il est possible facilement de renommer une page et de "garder" son ancienne URL active. Il explique qu'il a déjà parlé du renommage de pages avec olinuxx mais que celui-ci pense qu'on peut se passer de renommer les pages justement grace aux alias, sans plus d'explications. On met donc ce sujet de coté en attendant des nouvelles d'olinuxx.
On parle ensuite des nouvelles régles de nommage proprement dites.
Pianolivier propose de remplacer les underscore "_" par des espaces, pour améliorer l'affichage et les recherches google comme proposé plus haut. (comme chez tiki.org). Il en a déjà parlé à olinuxx qui semble être d'accord. Flo et ycollet le sont aussi.
Pianolivier précise qu'il n'y a plus d'excuse pour ne pas utiliser les raccourcis d'édition tiki pour insérer un lien, donc on se fout un peu du "+" que l'on obtient en copiant l'adresse à la main à partir de la barre d'adresse d'un navigateur (ce qui était une des raisons pour de pas avoir d'espace)
Pianolivier propose ensuite d'oublier les noms "hierarchiques" comme manuel_participer_wiki. Cela sert à classer les pages dans la liste des pages wiki, mais pianolivier ne voit pas vraiment à qui cela peut être utile ni pourquoi : cette liste contient un tas de pages "inutiles" (pages user, pages obsoletes...), il ne pense pas que c'est une bonne idée de conseiller sa visite de manière générale. Il en a parlé à olinuxx qui ne semble pas être d'accord avec cette proposition sans pour autant avoir précisé l'utilité de cette liste.
Flo remarque que garder une hierarchie dans le nom fait plus propre, et que si "installation de jack" sonne plus joli, on sent aussi une continuité dans "jack installation". Cependant lui non plus n'utilise pas la liste des pages et fait part de la possibilité que "installation de jack" soit mieux pour des recherches google. Cette proposition est mise de coté pour le moment.
Pianolivier propose ensuite, par soucis de consistance à travers le site, d'avoir pour règle d'écrire la première lettre en majuscule, et d'ajouter aux tutoriels le prefix "Tuto" (comme cela semble avoir été un des principes appliqué sporadiquement pour le moment)
Flo demande pourquoi on aurait besoin de ce prefix, et pourquoi il a déjà été appliqué à certaines pages. Personne ici ne connai la réponse.
Il fait aussi remarquer qu'on ajoute pas de préfix pour les autres pages, comme "Logiciel Jack" par exemple.
Ycollet pense aussi que le prefix est de trop, étant donné qu'on a accès à tous les tutos à partir de la page portail des tutos.
Pianolivier est d'accord pour oublier le prefix "Tuto".
Pianolivier propose ensuite de définir une bonne fois pour toute si les pages doivent avoir un nom au singulier ou au pluriel, histoire de pouvoir se souvenir des noms et de faire des liens facilement sur le forum ou ailleur.
Flo propose le pluriel, comme Synthétiseurs, en pensant encore une fois à google
Pianolivier est d'accord et propose d'ajouter aussi un alias avec le même nom au singulier àfin de pouvoir écrire dans les forums par exemple "tu as besoin d'un ((synthétiseur)) avec rosegarden" et/ou "va voir du coté des ((synthétiseurs))". Flo approuve.
Pianolivier propose ensuite, dans la mesure du possible, d'essayer d'obtenir des noms de pages qui peuvent être utilisés facilement dans une phrase sur les forums, comme "fais voir ton ((log de jack))". olinuxx a remarqué en privé un peu avant que cette règle devrai rester souple.
Pianolivier pense que, pour les pages ou cette regle n'est pas appliquable, on peut toujours créer un alias facile à utiliser dans une phrase.
Flo remarque qu'il ne faudrai peut-être pas abuser des alias, par peur de bug ou autre "mauvaise surprise", comme des posts sur les forums devenant obsolètes à cause de la disparition d'alias. Mais pianolivier est confiant sur la gestion cette fonction qu'il trouve "génial", de plus il explique qu'il connai déjà une technique pour remedier à ce problème spécifique, qui a été appliquée avec succès pour des pages disparues.
Pour les détails techniques : Pianolivier demande s'il faut cacher ou montrer les alias, et comment. Il explique qu'au début il a commencé par les cacher, car ils n'apportent rien à la lecture d'une page pour l'utilisateur, mais il s'est rendu compte, avec l'augmentation rapide du nombre d'alias qu'une fois cachés, on ne sait plus forcément quelle phrase/mot "facile" utiliser rapidement dans le forum. Pour le moment, il a donc utilisé des mini-paragraphe rétractable.
Flo est d'accord, mais olinuxx semble avoir une autre solution non encore expliquée, à voir.

Le sujet s'oriente sur l'organisation des pages wiki en général, et cette proposition de plan du site en particulier.
Flo commence en disant qu'il faudrait plus de tutoriels sur linuxmao, ce qui serai profitable aux nouveaux arrivants anciens-maoistes-mais-nouveaux-linuxiens mais aussi aux anciens-linuxiens-mais-nouveau-maoistes. Ces tutos devraient être mis en valeur dans les pages de logiciels qui les concernent, et le reste de la documentation devrait arriver en second.
Pianolivier approuve, il pense qu'il faut "seulement" que chacun s'y mette et fasse grossir le nombre de tutoriels (ndr : plusieurs des pages dernièrement créées sont des tutos). Il trouve la formule d'inserer un "tuto de démarrage" lors de la création de la nouvelle page sur un logiciel appropriée (ndr : ce que conseil le manuel du site).
Flo préférerai une page par tuto, ycollet approuve : par exemple "une page tuxguitar pour décrire le logiciel puis des pages tutos pour expliquer comment connecter tuxguitar à hydrogen, fluid, etc". A voir.
Flo demande ensuite s'il est possible de rendre les paragraphes "logiciels similaires" -en bas des pages de logiciels- dynamiques (mis-à-jour automatique)
Pianolivier ne sais pas comment faire cela, et souhaiterai supprimer ce paragraphe au profit de liens sur les catégories du portail logiciel et les autres pages de documentation présentant des logiciels similaires (certains coins comme Écrire la musique par exemple).
Flo est d'accord. Il faudra décider de quelle manière et quels liens seront présentés (comme un bandeau en haut de page, voir ce test).
Flo propose ensuite de placer une banière d'avertissement en haut des pages de logiciels de la liste des logiciels abandonnés?, avec une redirection sur un/des logiciels similaires plus récents. Pianolivier aime bien l'idée, à confirmer ensemble.
Chacun salut jmpc qui vient d'arriver et qui salut en retour.
Flo propose ensuite de standardiser les paragraphes "installation", en séparant clairement par distribution. Pianolivier aime bien cette idée aussi et montre une page qu'il a rédigé récemment dans cette veine : rtirq.
Ensuite flo explique que les tableaux créés dernièrement pour les versions de distributions (comme dans musescore) ne sont a son avis pas une bonne idée, car illisible et trop compliqué a maintenir.
Pianolivier est d'accord, il pense aussi de manière générale qu'un maximum d'information sur l'installation des logiciels devraient être centralisées dans les pages de distributions. Peut-être peut-on déplacer ces tableaux ? ou les supprimer ?
Flo n'a plus de remarques, pianolivier veux maintenant parler de l'organisation des pages de manière globale.
Il propose une définition du terme "portail" : entrée de premier niveau (dispo dans la colonne de gauche et dans le plan général du site), il ne faudrai pas plus de 5-6 portails en plus des autres entrées de premier niveau sur la doc (manuel du site, glossaire...). Un portail devrait se contenter de donner des liens sur des pages wiki (ou éventuellement d'autres type de pages). Il peut contenir des ensembles de pages ("dossiers") ou des pages seules. La boite "Entrez c'est ouvert" de gauche devrai contenir ces portails + glossaire, et les coins comme "débuter" devrait être disponible dans une autre boite "portail documentaire" (ou plus en évidence pour ce coin spécifique, dans une boite dédiée par exemple).
une définition du terme "dossier" : comme les portails, les pages "dossier" devraient se contenter de lister d'autres pages (mais pas de sous-dossier). Un dossier fait partie d'un "portail" et les pages listées tournent autour d'un thème unique. Un dossier parle à la fois de musique et/ou d'informatique en général, mais aussi de comment la mettre en pratique sous linux (avec les liens adéquoits sur les logiciels liés).
Flo est plutôt d'accord mais remarque qu'il n'aime pas trop le terme de "coin", pianolivier n'a pas de définition pour ceux-ci. Il semble qu'un coin peut à la fois être une sorte de dossier (le coin du débutant) et en même temps une page unique (le coin des guitaristes).
Pianolivier propose d'abolir les "coins" afin d'obtenir la structure :
? portail
?? dossier/catégorie
??? page
Pianolivier a commencé un mockup du potentiel portail documentaire ici.
Flo pense qu'il est présentée du manière un peu "fourre-tout", mais qu'il a néanmoins découvert une nouvelle page dedans.
Pianolivier répond qu'il y'a encore du travail à faire dessus pour le rendre cohérent, il hésite en particulier à transformer les portails "système" et "développer" en dossier. Flo pense que "système" devrait être un dossier, pour "développer" il faudra voir où mène la discussion lancée sur le sujet du forum dédié.
Ycollet s'excuse et part manger. Il est remercié de sa présence et il promet de s'occuper bientôt des pages sur tuxguitar qui lui tient à cœur. smile
Pianolivier demande ensuite à Flo s'il a encore des remarques sur le nouveau portail logiciel, celui-ci répond par la négative.
Pianolivier annonce alors qu'il espère finir de boucler/polir ce portail pendant le mois d'octobre afin de le mettre en service si tout le monde l'approuve. (il faudra cependant aussi régler cette histoire de Portail Documentaire au moins en partie)
Il y aura du travail à faire lors de la validation du portail : "baliser" toutes les pages d'applications avec un bandeau du genre de celui affiché sur la page de test aj-snapshot (et peut-être enlever le paragraphe "applications similaires" par la même occasion).
Flo veut bien aider à cela en cas de temps libre de son coté.

plus d'une heure et demie s'est écoulé depuis le début de la réunion.
Pianolivier n'a plus rien a dire pour ce soir, flo n'a rien à ajouter et jmpc est content d'avoir suivit cette discussion.
La prochaine réunion est fixée pour le samedi 15 à 17h29
(en esperant l'horaire propice à l'apparition d'olinuxx)

oliv'

pianolivier utilisateur non connecté France
bon y'a plusieurs choses à décider là dedans.
Pour plus de clareté, autant séparer les différents thèmes abordés dans plusieurs sujets de forum.

Pour ce qui concerne le renommage des pages et l'utilisation des alias, voir ce sujet du forum.

Pour ce qui concerne l'organisation interne des pages de logiciels (installation, paragraphe "logiciels similaires", intégration des tutos, "avertissement musée"), voir ce sujet du forum.

Pour ce qui concerne les définitions de termes, la structure générale de la documentation et le portail logiciel, voir ce sujet du forum.

Flo utilisateur non connecté
Encore une fois : super compte rendu ; Merci pianolivier !

pianolivier utilisateur non connecté France
coucou
je propose de reporter la prochaine réunion à une date ulterieure, lorsque l'on aura avancé sur les points développés ici.

oliv'

Afficher les articles :
Aller au forum :

Documentation [Afficher / Cacher]

Faire un don
[Afficher / Cacher]

Connexion
[Afficher / Cacher]



Mégaphone [Afficher / Cacher]

calixtus06, 09:30, mer. 27 mars 2024: Bonjour et bienvenue à Noar :-)
olinuxx, 18:50, lun. 25 mars 2024: Bonjour et bienvenue à Ted Demore cool
olinuxx, 17:52, dim. 24 mars 2024: Bonjour et bienvenue à Noitavon cool
calixtus06, 11:07, jeu. 21 mars 2024: Bonjour et bienvenue à obds, ceric :-)
obds, 16:12, mar. 19 mars 2024: Cet édito est juste parfait. Trop beau !
olinuxx, 11:48, ven. 15 mars 2024: Bonjour et bienvenue à Jerry cool
calixtus06, 18:03, mer. 13 mars 2024: Bonjour et bienvenue à tanguero :-)
olinuxx, 11:01, dim. 10 mars 2024: Bonjour et bienvenue à lolo cool
bda, 16:59, sam. 09 mars 2024: Chapeau pour l'édito. Vous êtes au top les gars :-)
allany, 07:20, jeu. 07 mars 2024: Ça ne fait jamais de mal, c'est l'éditorial ! [Lien]
olinuxx, 19:52, mer. 06 mars 2024: Bonjour et bienvenue à TrkNrk cool
calixtus06, 11:17, mar. 05 mars 2024: Bonjour et bienvenue à D752 :-)