Contenu | Rechercher | Menus

De l'évolution de la documentation

À Faire

  • Supprimer le plugin Cloud
  • Garder le plugin "page move" à l'esprit
  • Refaire les minitutos.

Réflexions

Le bon environnement

En fait c'est simple et compliqué à la fois, il serait marrant/intéressant/idéal que lorsque l'on se trouve sous doc.ubuntu-fr.org on ne retrouve que le mot "ubuntu" lorsqu'il s'agit d'une référence à notre distribution, ce même mot serait remplacé automatiquement par "kubuntu" sur doc.kubuntu-fr.org, et "xubuntu" sur doc.xubuntu-fr.org .

Je ne sais pas si c'est réalisable et cela impliquerait de remplacer ces références "ubuntu" par quelque chose du type {{distribution}} qui serait remplacé automatiquement.

Inutile si on se limite aux mots "Ubuntu", Kubuntu" etc. Il faut élargir l'idée a des paragraphes entiers (texte+captures), ce qui me parait une bonne idée à priori, mais compliquera la comprehension/edition de la source des pages pour les nouveaux contributeurs. — YannUbuntu 2009/07/06 09:37
C'est un doux rêve car compliquera les choses et diminuera les contributions. — Ner0lph 2009/07/17 23:45
je suis conscient qu'il faut que ça reste le plus simple possible pour que les contributeurs trouvent ça naturel. Pour ce qui est des blocs ce sera <ubuntu version> texte concerné </ubuntu>, syntaxe facilement compréhensible. Pour ce qui est du nom de distribution c'est plus compliqué à appréhender, donc je sais pas… peut être réfléchir à une solution plus large (remplacement d'occurrence automatiquement sauf si un certain tag ~~ubuntuonly~~ existe ou un truc du genre sur la page. — YoBoY 2009/07/21 09:48

Le filtrage des versions

La c'est mon esprit tordu qui imagine ça, mais il serait aussi agréablement intéressant pour les utilisateurs enregistrés qui auraient renseigné la version sur laquelle ils tournent dans leur profil, qu'ils n'aient que les informations relatives à cette version d'afficher sur une page. Cela impliquerait encore un niveau complémentaire de balises dans les pages à savoir inventer un tag <version 9.04>texte relatif à cette version</version>. Ces blocs seraient donc masqués et affichables d'un simple clic sur un lien. On pourrait voir en début de page quelque chose du style

affiche: 8.04 / 8.10 / **9.04** / Tout
La aussi il s'agit d'ajouter une syntaxe de filtrage par blocs. remarques idem filtrage d'environnement. — YannUbuntu 2009/07/06 09:37
Je ne suis pas convaincu… — Ner0lph 2009/07/17 23:45

La validation rapide

Cette fonction serait un bouton supplémentaire qui serait présent sur toutes les pages qui n'ont pas pour tag la dernière version d'ubuntu (Karmic en ce moment). Le principe serait de pouvoir lire une page, si elle est encore adéquate on valide juste avec ce bouton qui ajouterait le tag complémentaire sans besoin d'éditer la page et de l'enregistrer.

ok, si cette fonction est accessible uniquement par un utilisateur enregistré. — YannUbuntu 2009/07/06 09:37

Automatisation et harmonisation

Paquets des dépôts

Un autre point qu'il serait intéressant de rapprocher avec la doc c'est toute la documentation déjà existante et disponible sur notre système.

Les paquets d'abords sont une source d'information idéale (nom du paquet pour le nom de la page de documentation, description, nom du programme, site web officiel éventuellement). Il serait intéressant que les programmes accessibles par l'installateur "ajouter/supprimer…" et qui n'ont pas de page de documentation en ait une générée automatiquement avec ces informations de base, une structure simple de page (installation, configuration, liens).

On pourrait même pousser le raisonnement plus loin en imaginant que toutes les pages, même celles existantes possèdent ce lien étroit avec les paquets, cela permettrait peut être d'accélérer/améliorer la traduction/description de ces éléments. Cette structure complète pourrait être intégrée avec juste une balise du type {{official> nom_du_paquet}}

Formulaires spécifiques

On pourrait imaginer pour la création de nouvelles pages une série de questions pour orienter le rédacteur et créer automatiquement un squelette de page contenant déjà toutes les informations classiques "titre, description, …".

Me parait indispensable pour faciliter le travail des nouveaux contributeurs ! — YannUbuntu 2009/07/06 09:37
J'y ai pensé quand j'ai découvert qu'il existait au moins deux plugins (bureaucracy et form) permettant de faire cela. :-)Ner0lph 2009/07/17 23:45

Réglage divers

Module complémentaires

À tester

  • bookmarkme – liens vers les "marques pages sociaux". Je trouve que c'est intéressant de pouvoir marquer simplement une page sur notre "répertoire" de marques pages préférées. Donc je suis pour. Faudrait voir si ça ne perturbe pas les performances globales.

De l'utilisation des Tags

Base pour une refonte éventuelle de la page Thesaurus

Appliquer un tag c'est se demander : "Y a-t-il besoin d'une page regroupant des liens vers toutes les pages concernant ce sujet?"

Question 1: À partir de combien de pages est-il nécessaire d'avoir un tag pour gérer ce groupe de pages?

une petite dizaine? — YannUbuntu 2009/07/06 09:37

Versions d'Ubuntu/kubuntu/xubuntu

Anciennes versions qui ne sont plus supportées
Les pages et informations concernant ces versions sont amenées à disparaître, ainsi que ces tags.

  • Warty – Ubuntu 4.10 Warty Warthog
  • Hoary – Ubuntu 5.04 Hoary Hedgehog
  • Breezy – Ubuntu 5.10 Breezy Badger
  • Edgy – Ubuntu 6.10 Edgy Eft
  • Feisty – Ubuntu 7.04 Feisty Fawn – (synonymes: 7.04)
  • Gutsy – Ubuntu 7.10 Gutsy Gibbon – (synonymes: 7.10)

Versions supportées
Les pages doivent être écrite dans l'optique d'aider l'utilisateur sur toutes ces versions, et en particulier les versions LTS. Mettre les tags pour lequel les informations sur la page conviennent.

  • Dapper – Ubuntu 6.06 LTS Dapper Drake – (synonymes: 6.06 6.06_lts)
  • Hardy – Ubuntu 8.04 LTS Hardy Heron – (synonymes: 8.04 8.04_LTS)
  • Intrepid – Ubuntu 8.10 Intrepid Ibex – (synonymes: 8.10)
  • Jaunty – Ubuntu 9.04 Jaunty Jackalope – (synonymes: 9.04)

Versions en cours de développement Ces tags apparaissent à partir de la sortie de la première bêta (évitez d'écrire des informations sur des versions alpha qui peuvent ne plus être adéquates avec la version finale).

  • Karmic – Ubuntu 9.10 Karmic Koala (à paraître) – (synonymes: 9.10)

Les tags matériel

Tout matériel, périphérique externe, carte interne, chipset, ordinateur complet, … dont l'utilisation nécessite la création d'une page doit se voir attribué le mot-clé matériel (notez l'accent) suivi d'un ou plusieurs tags décrivant le type de matériel.

  • portable (pour les fixes, ne mettez que la marque)
    • Le type (facultatif) – netpc (eee et les autres) tabletpc
    • La marque (facultatif) – Acer Alienware Aopen Airis Apple Asus Averatec Clevo Compal Compaq Dell Fujitsu_Siemens Gateway Gericom Hewlett_Packard IBM I-Note Keynux Lenovo Materiel.net MaxData Medion MSI Nec Packard_Bell Panasonic Samsung Sony Targa Toshiba Uniwill Zepto
    • Le modèle (facultatif dépendant de la marque, peu utilisé)
  • carte_graphique
    • ATI – (synonymes: AMD-ATI)
    • nVidia
    • Intel
    • Les autres marques – Matrox Via 3DFx ne sont pas signalés en mots clés
    • Fonctions complémentaires – aquisition_video carte_tv(regroupe aussi les cartes TNT)
  • disque_dur – Les différents disques durs, externes généralement
    • Type de connectionusb firewire réseau
    • raid
    • multimédia
  • réseau – Tout ce qui touche au réseau
    • wifi
    • modem
    • routeur
  • carte_son – Les cartes sons
  • Les supports de stockage
    • disquette
    • zip
    • cd
    • dvd
    • bd
    • carte_mémoire
  • graveur – Les graveurs
    • cd
    • dvd
    • bd
    • usb
    • scsi
  • Les périphériques
    • souris
    • clavier
    • télécommande
    • tablette
    • webcam
  • imprimante – Les imprimantes de toute sorte
    • réseau
    • wifi
    • multifonctions
    • cartes_mémoire
  • scanner – Les scanners (hors imprimantes)
  • Les ports d'entrée/sortie
    • usb
    • firewire
    • PCMCIA
    • irda
    • bluetooth
    • scsi
    • série
    • parallèle
  • Les autres types de matériel
    • mobile
    • appareil_photo
    • caméra
    • clé_usb
    • sécurité
    • énergie

Les tags Logiciel

Ces tags permettent de catégoriser les logiciels, une bonne pratique est de voir comment sont taggés les logiciels similaire. Une autre bonne pratiques est de regarder où apparaît le raccourcis dans votre menu Applications, car celui ci est déjà dans une catégorie. En premiers tags on peux préciser à quel environnement de bureau le logiciel est destiné si tel est le cas ou quelle configuration il utilise.

  • Gnome KDE XFce
  • GTK QT Motif Java Console

Ensuite vient la catégorisation suivant le type de logiciel, une bonne pratique serait de suivre les catégories déjà définies par freedesktop.org

  • Audio
    • Média-thèque Radio Lecteur Musique
    • MIDI Mixer MAO Acquisition
    • Gravure
  • Vidéo
    • Média-thèque TV Lecteur Montage Acquisition
    • Gravure
  • Programmation
    • Debug IDE GUIDesigner Compilation Traduction Versioning bdd Gestion_Projet
  • Éducation
    • Art Construction Musique Langue Science IA Astronomie Biologie Chimie Informatique Économie Électricité Géographie Géologie Histoire Imagerie Littérature Math Médecine Physique Robotique Sport
  • Jeux
    • Action Aventure Arcade Plateau Casse_Brique Cartes Enfant Logique JDR Simulation Sport Stratégie Émulateur
  • Graphisme
    • Dessin Vectoriel 3D PAO Photo
    • Acquisition OCR Visionneuse
  • Internet
    • courrier messagerie Chat IRC Newsgroup Vidéo_Conférence
    • Téléchargement P2P Navigateur
    • Communication Radio Accès_Distant Téléphonie
  • Bureautique
    • Agenda Carnet_Adresses bdd dictionnaire courrier visionneuse
    • Présentation Tableur Traitement_Texte PAO
    • Comptabilité Gestion_Projet
    • PDA
    • Électronique Électricité CAD
  • Accessoires
    • Éditeur Sauvegarde Compression Navigateur_Fichier Accessibilité Calculatrice Horloge
  • Système
    • Emulateur Terminal Gestionnaire_Fichier Moniteur Sécurité Gestionnaire_de_paquets
  • Configuration
    • imprimante webcam scanner carte_graphique carte_son …
    • Bureau Fond_Écran Icônes Son
    • Sécurité Accessibilité

Cas des tutoriels

En premier lieu un tutoriel doit comporter le tag tutoriel.

Toutes les pages sont en quelque sorte des tutoriels, néanmoins on considère une page comme un tutoriel lorsque celle-ci fait appel à des notions et des procédures faisant généralement intervenir plusieurs applications.
Par exemple une page expliquant comment lire une vidéo en présentant les codecs et les divers programmes possibles est un tutoriel, alors qu'une page présentant totem le lecteur vidéo de gnome uniquement n'en est pas un.

En plus du tag tutoriel ces pages comportent les tags correspondant à ce qu'elles expliquent choisis dans les tags matériels et/ou les tags d'applications.

Quelques exemples

1- Une imprimante multifonction avec lecteur de carte testé sous Dapper Gutsy Hardy:

Dapper, Gutsy, Hardy
matériel, imprimante, multifonctions, carte_mémoire

2- Aptitude:

Dapper, Edgy, Feisty, Gutsy, Hardy
Console, Système, Gestionnaire_de_paquets

3- Totem:

Dapper, Edgy, Feisty, Gutsy, Hardy
Gnome], GTK, Audio, Vidéo, Lecteur

4- Tutoriel sur Comment accéder à ses partitions windows:

Dapper, Edgy, Feisty, Gutsy, Hardy
windows, Disque_Dur, Réseau, Navigateur de fichier

Nuage de tags

Le nuage de tags recense beaucoup de tags qui sont des erreurs ou qui ne devraient pas être utilisés

a_recycler aardvark abuledu accessibilite acer administration affichage agenda alienware amd-ati amorcage android animation anonymat antivirus apache apple application application_domestique apt arcade architecture archivage arithmetique artful astronomie asus asus_eee_pc ati audio authentification auto-hebergement automatisation baladeur bible bibliotheque bios bittorrent blu-ray bluetooth boot breezy brother brouillon budgie bug bumblebee bureau_a_distance bureautique c:c cad calcul calcul_collaboratif calcul_numerique calendrier camera canon cao capteur_mouvement capture capture_d_ecran capture_video carte carte_audio carte_graphique carte_heuristique carte_mentale carte_mere carte_tv cartographie catalyst cd chantier chiffrement chromebook cifs cinnamon classroom clavier cle_usb_artec_t14br cles_3g clevo cli client cloud cms codedeconduite collectivite college commande_shell commandes comment_participer communaute communication compaq compilation comptabilite conception_electronique configuration console construction contacts controle_parental couleur courriel courrier course crm cron cups cvs cycle_1 cycle_2 cycle_3 dactylographie dao dapper deb debutant decrypter deja-dup dell depots developpement developpement_de_jeux_video diagnostic diagnostic_outil diagramme diaporama dictionnaires_encyclopedies discord disque_dur disquette djvu dlna dns documentation_hors_ligne domino domotique doom dosbox dossiers droits dual-boot dvd e-book ebauche ebook ebr echecs eclipse ecran ecran_tactile edgy editeur_de_texte edubuntu educatif education eduction eeepc email empreinte_digitale emulateurs_console emulateurs_ordinateur emulation encodage energie enlightenment entreprise environnements epub erp ethernet extension extensions_gnome facebook fao faq faq_liste fax feisty fenetre_de_connexion ffmpeg fichier finances firefox fixme flash flashplayer flv fond_d_ecran format forum fps francais freebox freebox_revolution freeboxv6 freenx freeplayer fstab ftp fujitsu-siemens fuse gcc ged genealogie generateur gestion gestion_commerciale gestion_de_bibliotheque_multimedia gestion_de_parc gestion_de_projet gestionnaire gestionnaire_de_fenetres gestionnaire_de_fichiers gestionnaire_de_jeux gestionnaire_de_paquets gestionnaire_de_photos gestionnaire_de_telechargements gimp git gmao gnome gnome_applets gnu google gps grapheurs graphisme gravure grouar groupe groupetraducteur grub grub-pc grub_pc gtkpod gui guitare gutsy gvim hamradio hardy haute_disponibilite hdmi hebergement hoary hp html hubic hyperviseur i2p icc ide impression imprimante imprimantes indicateurs indicator-applications industrie infographie ingenierie inspiron installation installation_logiciel intel intel_graphics intelligence_artificielle interface_3d interface_neuronale internet intranet intrepid inventaire ipc iphone ipod ips ipv6 irc iso jabber jack japonais jaunty java jdr jeu joystick karmic kde kdeconnect kernel key krdc kubuntu lamp lanceur_de_logiciel langage langue latex launchpad ldap le_terrier lecteur_audio lecteur_empreinte lecture_et_encodage_de_fichiers_videos lettre_hebdo_archive lexmark librairie libreoffice lifi lightdm lightscribe linguistique linux lire_un_dvd liste_applications_legeres listelogiciels live-cd live_cd live_usb livecd livre loadaverage loco logiciel logiciels logiciels_d_apprentissage_de_langues logiciels_educatifs_pour_les_enfants logiciels_enseignement logiciels_pour_le_lycee logitech ltsp lubuntu lucid lvm lxde lxqt mac macbook magazine mail mame mao marques-pages mate materiel materiel_libre maternelle math mathematiques matroska maverick mbr mcabber md5sum mecanique media_center menu_systeme messagerie_instantanee microcontroleur midi migration mindmap minecraft mise_a_niveau mkv mkvtoolnix mmorpg mobile mod modele modelisation_3d modem moissan moniteur mono montage montage_video morphing moteur_de_recherche motion mplayer mtp multicast multifonctions multijoueurs multimedia multitouch mysql nagios nas natty nautilus nautilus-actions navigateur navigation_maritime nds netbook netboot netflix netinstall netsoul nettoyer_ubuntu nfs ngspice nintendo nodejs normalisation normaliser nuage nvidia nvidia_optimus obsolete ocr oem off-the-record_messaging openbox opencl openpgp openstreetmap openvpn optimisation orthographe overclock owncloud p2p packard_bell pam panorama paquet pare-feu partage participer partitions path pcsc-tools pda pdf periodique personnalisation personnaliser personnaliser_livecd photo photos php phpmyadmin pidgin pilote playonlinux plugin_navigateur police portable portail portail_captif postfix poulsbo ppa precise presse-papier primaire processeur profil proftpd programmation programmation_visuelle projets proxy ps3 psp publier putty python qemu qt quantal radeon radio raid raid1 ratp raw rclone rclone-browser realtek recherche recherche_de_fichiers reconnaissance_vocale recuperer reflexion regles_du_forum reseau reseau_social resolution rhythmbox robotique rootkit rpc rpg rss rtl-sdr rtl2832u rtp rts rythme samba samsung sante satellite sauvegarde scanner science sciences script scripts_utiles securite seedbox serveur serveur_mail serveurs_messagerie service services seveur sflphone sfr sgbd shell shotwell sig signer simulation sip sncf snmp solaar son sony souris sous-titrage space-opera space_opera sport spring ssd ssh steam stereoscopie stif stopmotion strategie streaming sudo supervision swap synchronisation systemd systeme systeme_de_fichiers tableau tablette_graphique tactile tags tbs team telecommande telephone telephonie television terminal test_tag texte thunderbird tnt tnt_frequences toshiba toulouse traducteur traduction traduire travail_colaboratif travail_collaboratif tremulous trusty tutoriel tutoriel:utilisation_avancee_du_clavier tutos_aide tux tv ubuntu ubuntu-l10n-fr ubuntu_64bits ubuntu_server ubuntu_sso ubuntu_studio ubuntukylin ubuntuone uefi unity upnp urls usb utilisateur utilisateur_wiki utilisateurs utilisateurs:moissan utilitaire variables_d_environnement variante variantes version_ubuntu versions vetuste video videosurveillance vim virtualisation visioconference visionneuse visual_basic vnc voip vpn vsftpd wacom wayland web webcam webm webmail webradio webtv whiteboard wifi wii wiki wiki:modele wiki:tag wiki:tutoriel windows wine xbmc xenial xfce xmpp xubuntu ​logiciels


Le contenu de ce wiki est sous licence : CC BY-SA v3.0