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 12.04 12.10 14.04 14.04.3 2d 3d a_recycler a_supprimer a_supprimert abuledu accessibilite accueil acer acroread administration adobe affichage affichage_dynamique agenda aide airplay alacarte alienware amd-ati amd64 amorcage android animation anonymat anti-vol antispam antivirus apache apple application application_domestique apt apt-get aptitude arcade architecture architecture_materielle architecture_processeur archivage arithmetique assembleur astronomie asus asus_eee_pc ati ativ_book9_lite audio authentification auto-hebergement automatisation automobile automount axis backtrack backup baladeur barre_des_taches battle.net beid belgium bi bibliotheque bios bits bittorrent bkchem blink blizzard blu-ray bluedevil bluetooth boot boot_usb bootloader box box2d breezy brother brouillon brouilon bug bumblebee bureau_a_distance bureautique c c:c cad calcul calcul_collaboratif calcul_numerique calendrier camera can-bus canon canoscan_lide_100_200 cao capteur_mouvement capture capture_d_ecran capture_video caracteres carte carte_audio carte_graphique carte_heuristique carte_mere carte_tv cartographie casper-rw catalyst cd cdrip chantier chargeur_d_amorcage chiffrement chinois chromebook chromecast chromium-browser cifs clavier cle_usb cle_usb_artec_t14br cles_3g cli clignotement cloud cms codedeconduite collectivite college commande commande_shell commandes comment_installer_un_paquet comment_participer commodore communaute communication compaq compilation compiler compression comptabilite conception_electronique configuration conky console constructeur construction container controle_parental conversion coreboot courriel courrier course creer_une_cle_bootable crm cron cups cvs cycle_1 cycle_2 cycle_3 dactylographie dao dapper dash db de deb debian debian_jessie debutant decrypter dedie dell depots derivees_d_ubuntu des developpement developpement_de_jeux_video diagnostic diagnostic_outil diagramme diaporama dictionnaires_encyclopedies digital_signage direct disque_dur disquette djvu dlna dm-crypt dns docker documentation documentation_hors_ligne documentation_marketing_ubuntu domino domotique dongle donnees_personnelles doom dosbox dossiers dovecot dpkg droits dual-boot dual_boot dvd dvi dyslexie e-book e4 ebook ebr echecs eclipse ecole economiseur_d_ecran ecran ecran_de_veille edgy editeur_de_texte edubuntu educatif education effets_speciaux efi email emulateur emulateurs_console emulateurs_ordinateur emulation encfs encodage energie enlightenment entrainement_sportif entreprise environnement environnements eog epson epub erp esclave espace_disque ethernet exploits explorateur exporter extension extplorer f_st facebook fao faq faq_liste farming fast fax feisty fenetre_de_connexion festy ffmpeg fichier fichiers finances firefox fixe fixme fl flash flash_rom_android flashplayer flv fond_d_ecran format forum fps francais freebox freebox_revolution freeboxv6 freefilesync freenx freeplayer fruityloops fstab ftp fujitsu-siemens fuse fusion_wbfs gadget gaim gcc gdal ged genealogie geocaching geographie geolocalisation 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 gigabyte gimp git gjs gnome gnome-encfs-manager gnome-shell gnome_applets gnu google gparted gps grapheurs graphique graphisme grass gravure grouar groupe groupes groupetraducteur groupware grsync grub grub-pc grub_pc gtk gtkpod gucharmap gui guitare gusty gutsy gvim gwt h._peter_anvin hamachi hamradio hardy haute_disponibilite hdmi hearthstone hewlett hoary hp html hubs hyperviseur i2p ibm ide ideapad impression_sous_ubuntu imprimante imprimantes indicateurs indicator indicator-applications industrie ingenierie inspiron installation installation_logiciel installer_ubuntu_avec_le_live_cd installer_windows intel intel_graphics intelligence_artificielle interaction interface interface_3d interface_neuronale internet internet_et_reseaux intranet intrepid intuos4 intuos5 inventaire ip iphone ipod ips ipv6 irc iso isolation itineraires jabber jack japonais jaunty java javascript jdr jessie jeu jeux jeux_de_role joystick kaffeine karmic kazam kde kdeconnect kernel key kinect krdc kubuntu l500 l501x lamp lanceur_de_logiciel langage langue latex launchpad laurux ldap le_terrier lecteur_audio lecture_et_encodage_de_fichiers_videos led lenovo lettre_hebdo_archive lexmark libreoffice lightdm lightscribe ligne linguistique linthesia linux linuxsampler lire_un_dvd liste_applications_legeres liste_carte_graphique liste_des_fenetres liste_portables_acer liste_portables_hp liste_portables_hp_spectre liste_portables_toshiba liste_portables_uniwill liste_tutoriel listelogiciels live live-cd live-usb live_cd live_usb livebox 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 ltsp lubuntu lucid luks lvm lxc lxde m4600 mac macbook macbook_pro macintel magazine mail maintenir_systeme mame mao marques-pages mate materiel materiel_libre maternelle math mathematiques matroska maverick mavericks mbr mcabber md5sum mecanique media_center mediacenter menu menu_systeme menueditor messagerie_instantanee metacity microblogue microcontroleur midi migration minecraft mise_a_jour mise_a_niveau mkv mkvextract mkvtoolnix mmorpg mms mod modelisation_3d modem modem-usb module moleculaire molecules moniteur montage montage_video morphing moteur moteur_de_recherche motion mp3 mp620 mplayer mr3020 msi mtp multicas multicast multifonction multifonctions multijoueur multijoueurs multimedia multisystem mx 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 notification_erreur noyau ntfs nvidia nvidia.run nvidia_optimus obd-ii obsolete ocelot ocr oem off-the-record_messaging office ogg oneiric oneirick oniric openbox opencl openpgp openstreetmap openvpn openwrt optimisation orthographe orthographe_a_corriger os_x ouapi overclock owncloud p2p packard packard_bell palmos pam pamusb panorama paquet pare-feu partage parted partition partitions patients pc pda pdf performance performance_energetique_des_batiments periodique persistance personnalisation personnaliser_livecd photo photos php phpmyadmin physique piano pidgin pilot pilote piratebox pixel_mort playonlinux plone plugin plugin_navigateur pocketpc point_de_vente police portable portail portail_captif postfix poulsbo powerpc ppa ppc precies precise precise_quantal_raring_saucy_trusty precise_trusty precisetrusty precision presario presse-papier primaire probleme problemes_catalyst probook processeur proftpd progiciel_de_gestion_integre programmation programmation_visuelle projets proxy ps ps3 publier putty python qgis qosmio qrcode qreator qrencode qt qtqr quanntal quantal quickly radeon radio raid raid1 raring raw razer realtek recherche recherche_de_fichiers reconnaissance_faciale reconnaissance_vocale recuperer reflexion regles_du_forum requetes reseau reseau_social resolution ressources_humaines restauration rhythmbox ricoh ringtail robotique root_rom_android rootkit rpg rs-232 rss rsync rtl-sdr rts ruby rythme s10-3t s300 sagem samba samsung sante satellite satellite_c670d-11l saucy sauvegarde sauvegarde_de_wiki sc scanner scantool scantool.net science scientifique screencast script script_shell scripts scripts-fu scripts_utiles seabios secure_remix_13.04 securite seedbox serie seriel serverx serveur serveur_mail serveur_web serveurs_messagerie service services servlet seven sflphone sgbd shell shotwell shoutcast shoutcastexplorer shumway sig sig_systeme_information_geographique signer simulateur simulation simulator sip smartphone sms smtp snmp socks son sony souris sous-titrage space-opera space_opera spam sport spring sreenshot srt ssh ssl steam stereoscopie stopmotion strategie streaming studio sublime_text subtitles sudo supervision surveillance svg svn swap switchs swt symbian synchronisation synchroniser syncml synology synthesia synthetiseur synthetiseurs syslinux systemd systeme systeme_de_fichiers t61p tableau tablette tablette_graphique taches tactile tactiles tag tags tahr task taskwarrior tatouage tbs tcl:tk teachertool team telecommande telephone telephonie television temps_reel terminal terra test_tag tew424ub the thinkpad thunderbird tickets tiff tkinter tnt torchat toshiba touchpad touchsmart toulouse toutes_versions traducteur traduction traitement trames travail_colaboratif travail_collaboratif tremulous trendnet truecrypt trust trusty ts tutoriel tutoriel:utilisation_avancee_du_clavier tux tv twitch u270 uart ubuntu ubuntu-l10n-fr ubuntu_64bits ubuntu_arm ubuntu_entreprise ubuntu_server ubuntu_studio ubuntuone uefi unicorn unity unity-lens unity_launcher_folders upnp urls usb usb3 utilisateur utilisateurs utopic v3.1 v31 variable variables variante variantes version_ubuntu versions vervet vetuse vetuste video videosurveillance vim virtualbox virtualisation virtualtabletop virus visioconference visionneuse visionneuse_bureautique visual_basic vivid vnc voip vol vpn vsftpd wacom wamp web webcam webcamvirtuelle webm webmail webtv whiteboard wi-fi wifi wifi_problemes wii wiibafu wiimote wiki wiki:modele wiki:pico wiki:tag wiki:tutoriel wily windows windows_7 wine wippien wwan xampp xenial xenomai xense xfce xforwarding xmpp xonar xorg xorg.conf xorg.conf.d xpenology xps xubuntu xunlei xv xv2flv zbar-tools zenity zoneminder zsync 4 64 800 2015 7000 8187


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