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

11.04 14.04 14.04.3 16.10 17.04 2d 3d a a_recycler a_supprimert abuledu accessibilite accueil acer acroread administration adobe affichage affichage_dynamique agenda airplay ajaxplorer alacarte algorithme alienware amd-ati amd64 amorcage ancien android animation anonymat antivirus apache apple application application_domestique apt apt-get aptitude arcade architecture architecture_materielle architecture_processeur archivage arithmetique astronomie asus asus_eee_pc ati ativ_book9_lite audio authentification auto-heberge auto-hebergement automobile automount axis backtrack backup baladeur battle.net bi bibliotheque bios bits bittorrent bkchem blink blizzard blu-ray bluedevil bluetooth boot bootloader box box2d breezy brother brouillon bug bumblebee bureau bureau_a_distance bureautique c c:c cad calcul calcul_collaboratif calcul_numerique calendrier camera can-bus canon cao capteur_mouvement capture capture_d_ecran capture_video caracteres carte carte_audio carte_graphique carte_heuristique carte_mere carte_tv cartographie casper-rw casque catalyst cd cdrip chantier chargeur_d_amorcage chiffrement chinois chromebook chromecast chromium-browser cifs classroom clavier cle_usb cle_usb_artec_t14br cles_3g clevo cli clignotement cloud cms code_source codedeconduite collectivite college commande_shell commandes comment_installer_un_paquet comment_participer commodore communaute communication compaq compilation compiler comptabilite conception_electronique configuration conky connaitre_son_processeur console construction contacts controle_parental conversion coreboot couleur courriel courrier course crm cron cubuntu cups cvs cycle_1 cycle_2 cycle_3 dactylographie dao dapper dash db deb debian_jessie debutant decrypter dedie dell depots derivees_d_ubuntu desktop desuetude developpement developpement_de_jeux_video diagnostic diagnostic_outil diagramme diaporama dictionnaires_encyclopedies digital_signage disque_dur disquette distance divers djvu dlna dm-crypt dns documentation_hors_ligne documentation_marketing_ubuntu domino domotique donnees_personnelles doom dosbox dossiers dovecot dpkg droits dual-boot dual_boot dvd dvi dyslexie e-book ebook ebr echecs eclipse ecole ecran ecran_de_veille ecran_tactile edgy editeur_de_texte edubuntu educatif education eeepc effets_speciaux email empreinte_digitale emulateurs_console emulateurs_ordinateur emulation encfs encodage energie enlightenment entreprise environnement environnements eog epub erp ethernet explorateur extension extplorer facebook fao faq faq_liste farming fax feisty fenetre_de_connexion ffmpeg fichier finances firefox fixme flash flash_rom_android flashplayer flv fond_d_ecran format forum fprint fps francais freebox freebox_revolution freeboxv6 freefilesync freenx freeplayer fstab ftp fujitsu-siemens fuse fusion_wbfs gadget gaim gcc gdal 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 gjs gnome gnome-encfs-manager gnome-shell gnome_applets gnu google gps grapheurs graphique graphisme grass gravure grouar groupe groupetraducteur grsync grub grub-pc grub_pc gtk gtkpod gucharmap gui guitare gutsy gvim gwt h._peter_anvin hamachi hamradio hardy haute_disponibilite hdmi hearthstone hebergement hebergeur hoary hp html hubs hyperviseur i2p icc ide impression impression_sous_ubuntu imprimante imprimantes indicateurs indicator indicator-applications industrie infographie ingenierie inspiron installation installation_logiciel installer_ubuntu_avec_le_live_cd intel intel_graphics intelligence_artificielle interaction interface interface_3d interface_neuronale internet intranet intrepid inventaire ip iphone ipod ips ipv6 irc iso isolation itineraires jabber jack japonais jaunty java javascript jdr jeu jeux_de_role joystick kaffeine karmic kazam kde kdeconnect keepass2 keepassx kernel key kinect krdc kubuntu l500 lamp lanceur_de_logiciel langage langue latex launchpad laurux ldap le_terrier lecteur_audio lecteur_empreinte lecture_et_encodage_de_fichiers_videos led lettre_hebdo_archive lexmark librairie libreoffice lightdm lightscribe linguistique linux linuxsampler lire_un_dvd liste_applications_legeres liste_carte_graphique liste_portables_toshiba liste_portables_uniwill listelogiciels live-cd live-usb live_cd live_usb livecd livre lmms loadaverage loco logiciel logiciels logiciels_d_apprentissage_de_langues logiciels_educatifs_pour_les_enfants logiciels_enseignement logiciels_pour_le_lycee logitech logitechmediaserver loupe lscpu ltsp lubuntu lucid luks lvm lxde mac macbook macintel magazine mail maintenir_systeme mao marques-pages mate materiel materiel_libre maternelle math mathematiques matroska maverick mavericks mbr mcabber md5sum mecanique media_center menu menu_systeme menueditor messagerie_instantanee metacity microblogue microcontroleur midi migration mime minecraft mint mise_a_niveau mkv mkvextract mkvtoolnix mms mobile mod modelisation_3d modem modem-usb moleculaire molecules moniteur mono montage montage_video morphing moteur moteur_de_recherche motion mp620 mplayer mr3020 msi mtp multicas multicast multifonctions multijoueur multijoueurs multimedia multitouch mysq mysql nagios nas native natty nautilus nautilus-actions naviextras navigateur navigation_maritime nds netbook netboot netemul netflix netinstall netsoul nettoyer_ubuntu nfs ngspice nintendo nodejs normalisation normaliser notes noyau nuage nvidia nvidia_optimus obd-ii ocelot ocr oem off-the-record_messaging oneiric oneirick openbox opencl openpgp openstreetmap openvpn openwrt optimisation ordinateur oreillette orthographe os_x ouapi overclock owncloud p2p packard_bell pam pamusb panorama paquet pare-feu partage parted partitions path patients pda pdf pear performance_energetique_des_batiments periodique persistance personnalisation personnaliser_livecd personnaliser_path personnel photo photos php php.ini phpmyadmin physique pidgin pilote piratebox pixel_mort playonlinux plone plugin_navigateur police portable portail portail_captif postfix poulsbo powerpc ppa ppc precies precise precise_quantal_raring_saucy_trusty precise_trusty precisetrusty presario presse-papier primaire problemes_catalyst processeur processor profil proftpd progiciel_de_gestion_integre programmation programmation_visuelle projets projets:ecole proxy ps ps3 psp publier putty python qemu qgis qrcode qreator qrencode qt qtqr quanntal quantal quickly radeon radio raid raid1 raring raw realtek recherche recherche_de_fichiers reconnaissance_vocale recuperer reflexion regles_du_forum requetes reseau reseau_social resolution ressources_humaines rhythmbox ringtail robotique root_rom_android rootkit rpg rs-232 rss rsync rtl-sdr rtl2832u rtp rts rythme samba samsung sante satellite satellite_c670d-11l saucy sauvegarde sauvegarde_de_wiki sc scanner scantool scantool.net science scientifique screencast script scripts_utiles seabios secure_remix_13.04 securite seedbox seriel serveur serveur_mail serveurs_messagerie service services seveur sflphone sfr sgbd shell shotwell shoutcast shoutcastexplorer sig sig_systeme_information_geographique signer simulation simulator sip smartphone sms smtp snmp socks solaar son sony souris sous-titrage space-opera space_opera sport spring sreenshot srt ssd ssh steam stereoscopie stopmotion strategie streaming sublime_text subtitles sudo supervision svg swap switchs swt synchronisation synology syslinux systemd systeme systeme_de_fichiers tableau tablette tablette_graphique tactile tags tbi tbs tcl:tk team telecommande telephone telephonie television temps_reel terminal test_tag thunderbird tickets tiff tkinter tni tnt tnt_frequences torchat toshiba touchpad touchsmart toulouse tout-en-un toutes_versions traducteur traduction trames travail_colaboratif travail_collaboratif tremulous trsuty truecrypt trusty trusty_tahr ts tutoriel tutoriel:utilisation_avancee_du_clavier tux tv uart ubuntu ubuntu-l10n-fr ubuntu_64bits ubuntu_arm ubuntu_entreprise ubuntu_server ubuntu_studio ubuntuone uefi uname_-m unicorn unity unity-lens upnp urls usb usb3 utilisateur utilisateurs utopic validity variables_d_environnement variante variantes version_ubuntu versions vervet vetuste video videosurveillance vim virtualbox virtualisation virtualtabletop visioconference visionneuse visionneuse_bureautique visual-basic visual_basic vivid vnc voip vpn vsftpd wacom wamp web webcam webcamvirtuelle webm webmail webradio webtv whiteboard wi-fi wifi wii wiibafu wiimote wiithon wiki wiki:modele wiki:tag wiki:tutoriel wily windows wine wippien wwan xampp xbmc xdg-open xenial xenomai xense xfce xmpp xonar xpenology xubuntu xunlei xv xv2flv yak yakkety zapus zbar-tools zenity zesty zoneminder zsync 4 64 2015


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