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

1 - La documentation et les nouvelles de LinuxMAO

> Forums de discussion > 1 - La documentation et les nouvelles de LinuxMAO > [chantier] Organisation des pages logiciels
Dernier post

[chantier] Organisation des pages logiciels

Flo utilisateur non connecté
Bonjour à tous !

Pour l'instant les pages logiciel sont plutôt formatées comme écrit dans la page : SITE_fonctionnement_wiki_charte_documentaire
Mais il y a plusieurs points qui me dérange dans cette organisation.
  • la partie "compatible" me paraitrait plus adaptée dans description que dans information, en plus, ça permettrais de la développer un peu.
  • La partie changelog relève plus de la description que de l'utilisation.
  • d'abord on installe et après on utilise, autant suivre la logique des choses.

Ensuite, quelques idées me sont venues en visitant d'autres site, notamment avec cette page http://projet-plume.org/fr/fiche/giacxcas : par exemple le contexte d'utilisation, ou chacun y mettrais, bah dans quel contexte il utilise cette application. Ainsi ça pourra aider les autres utilisateurs dans leur choix en évitant d'essayer 50 logiciels différents, et ça pourra aussi donner des idées d'utilisation auxquelles on aurait pas pensées.

Voilà donc comment je verrais une page logiciel :
*Informations
*Description
**Fonctionnalités générales
**(Autres fonctionnalités)
**Compatibilité - Interopérabilité
**Contexte d'utilisation
**Changelog (replié)
*Installation (replié)
*Configuration
*Utilisation
*Liens

Pour vous donner une idée du résultat, j'ai fait un test avec la page de MuseScore.

Voilà, j'attends vos avis.

Flo

ycollet utilisateur non connecté France
Bonjour,

Est-ce qu'ajouter une section "tutoriels" n'aiderai pas ?

*Informations
*Description
**Fonctionnalités générales
**(Autres fonctionnalités)
**Compatibilité - Interopérabilité
**Contexte d'utilisation
**Changelog (replié)
*Installation (replié)
*Configuration
*Utilisation
*Tutoriels

Flo utilisateur non connecté
Salut ycollet,

Ça m'a plutôt l'air d'une bonne idée !
Mais certains tutoriels peuvent aller dans configuration ou utilisation. À méditer donc... Je vais essayer de réfléchir à ce que ça pourrais donner sur certaines pages.

Flo

pianolivier utilisateur non connecté France
coucou Flo,

On en a déjà discuté en privé, mais je vais re-donner mon avis ici pour le reste du monde.

Citation :
la partie "compatible" me paraitrait plus adaptée dans description que dans information, en plus, ça permettrais de la développer un peu.

pas d'accord :
Pour commencer j'ai renommé "compatible" en "support" dans le manuel du site car il y a eu mismatch à un moment, la plupart des pages parlent de "support" (Je pense que les deux termes peuvent convenir). J'en ai profité pour affiner l'ordre "licence", "plateforme", "support" ce qui me semble logique.
Je pense que la ligne "support" devrait rester dans le premier paragraphe ("infos"), car il s'agit d'un des premiers trucs à lire : par exemple si on recherche une appli avec support jack on passera directement à la page suivante lorsqu'on ne voit pas "jack" dans "support".
Je ne pense pas que c'est une bonne idée de développer cette ligne qui doit rester lisible en un coup d'œuil. J'ai proposé une définition de ce qui devrait être inclus dedans sur la page fonctionnement du portail logiciel?. L'avantage aussi avec une ligne courte, c'est qu'on peut la recopier facilement dans les tableaux du portail logiciel et éventuellement d'autres pages de présentation d'applications.
Olinuxx avait proposé à un moment de mettre cette ligne "support" dans des variables pour chaque application pour pouvoir l'utiliser dans plusieurs pages (comme pour les "versions"). Ca n'irait pas vraiment car il n'est pas possible d'inserer des liens dans les variables, mais l'idée générale est excellente : à terme il faudra utiliser un système dynamique pour le "support" et 2/3 autres trucs
Enfin, si ton idée est de rajouter des éléments dans "support" comme le type de fichiers utilisés par une app, alors il faut simplement le faire en effet dans "description", en plus du "support" actuel dans "info". Dans ce cas il vaut mieux utiliser d'autres termes comme "types de fichiers reconnus"...

Citation :
La partie changelog relève plus de la description que de l'utilisation

pas d'accord :
ca relève un peu des deux en fait, mais les changelogs (et je suis bien placé pour le savoir car j'en ai lu/traduit un paquet) expliquent le plus souvent des modifications sur la facon d'utiliser un logiciel, et seulement parfois présentent les nouvelles fonctions (mais souvent avec des explications sur leur utilisation)... rolleyes
Aussi, les changelogs ont pour public les personnes qui utilisent déjà le soft, et ne sont donc pas à priori interressé par le paragraphe "présentation". Les personnes qui découvrent un soft se foutent un peu de savoir que telle fonction est nouvelle.
Enfin, généralement les changelogs sont moins beaux/interressants que la documentation sur linuxmao (et devraient d'ailleur être intégré aux différents paragraphes de la doc, c'est le but), aussi mieux vaut les cacher le plus bas possible dans la page, et les supprimer lorsque qu'ils son trop vieux/nombreux et ont été documentés sur la page.

Citation :
d'abord on installe et après on utilise, autant suivre la logique des choses.

pourquoi pas :
mais il faudrai retrouver les anciennes discussions à ce sujet dans le forum (2010 je pense) avant de défaire ce que certains ont fait : ils devaient bien avoir des arguments pour mettre "install" après "utilisation" à prendre en compte ici.

Citation :
*Description
**'Fonctionnalités générales
**(Autres fonctionnalités)
**Compatibilité - Interopérabilité
**Contexte d'utilisation

Développer le paragraphe description avec ces sous-paragraphes plus précis, et le "Contexte d'utilisation" est sûrement une bonne idée.
Cependant, je pense que le "patron" des pages wiki dispo dans le manuel devrait rester le plus simple possible pour encourager les gens à se lancer, donc faire seulement mention d'un paragraphe "Description" dans un premier temps.
On pourrai peut-être se faire une "page d'admins wiki" avec ce genre de trucs.
edit : voir page de documentation idéale?

Je te laisse méditer pour les tutos wink

oliv'

barbux utilisateur non connecté
Je suis assez d'accord avec tout ce qu'a dit pianolivier. Je vais juste rebondir sur une chose :

pianolivier écrit :
Citation :
d'abord on installe et après on utilise, autant suivre la logique des choses.

pourquoi pas :
mais il faudrai retrouver les anciennes discussions à ce sujet dans le forum (2010 je pense) avant de défaire ce que certains ont fait : ils devaient bien avoir des arguments pour mettre "install" après "utilisation" à prendre en compte ici.


Je trouve ça assez logique de mettre l'utilisation avant l'installation. La partie utilisation va me permettre de savoir si le logiciel va me convenir et c'est après que je vais envisager de l'installer.

pianolivier utilisateur non connecté France
bon on en est ou ici ?

Lors de la réunion, on avait aussi parlé de mettre en place une bannière d'avertissement pour les logiciels libres abandonnés.
Voici pour test : Aldrin
soit :
? on garde la description rapide en premier puis vient la bannière qui est composée de :
? une petite image dédiée
? un avertissement standard en gras
? la raison personnalisée pour laquelle le logiciel est "abandonné" avec un lien sur un/des softs plus actuel(s)
si ça convient on fait pareil pour les autres wink

oliv'

olinuxx utilisateur non connecté France
Fusion de 2 sujets similaires, celui-ci et Organisation interne des pages du site (à lire).

Au passage, plutôt que " avec un lien sur un/des softs plus actuel(s)", il me parait plus logique de mettre un lien sur les listes de catégories et/ou les pages de type "les boites a rythme".

Olivier

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 :-)