comment repérer une documentation moisie ?

Le web déborde malheureusement de documentations, tips, tutos, inadaptés, dépassés, ou de mauvaise qualité.

Dans la mesure du possible référez-vous avant tout à la documentation officielle de l'outil que vous cherchez à utiliser. Malheureusement elle n'est souvent disponible qu'en anglais. C'est un peu la raison pour laquelle ce wiki ubuntu-fr est aussi fourni : il pallie parfois aux manques de certains éditeurs.

Quand on soumet son problème à un moteur de recherche, il peut nous amener n'importe où, et c'est là qu'il faut être vigilant : on trouve énormément d'articles qui existent seulement dans le but d'augmenter le référencement d'un site qui vend de la publicité, des produits ou des services (peu importe la qualité du texte)…
Le problème est le même avec une IA, d'ailleurs ces articles sont désormais le plus souvent générés par IA (puis repris par une autre IA, etc.).

Ces textes se basent initialement sur des conseils d'utilisateurs, rédigés avec sûrement de bonnes intentions, mais souvent parce que "ça marche chez moi"… après avoir tâtonné et sans forcément avoir les connaissances nécessaires à la publication d'un tel guide. Malheureusement au final ce détail est presque toujours occulté !

Cela peut mettre en danger les utilisateur·ice·s en diminuant le niveau de sécurité de leurs machines ou leur fiabilité, poser divers problèmes qui n'apparaissent pas forcément tout de suite (mais lors de la prochaine mise-à-jour, peut-être).

et il suffit de peu pour mettre le zbeul dans une installation linux…

Mieux vaut éviter de déterrer des docs et tutos anciens : vérifiez en premier lieu la date d'édition des informations qui vous sont proposées ! Si la date n'est pas indiquée, essayez de repérer des numéros de versions des logiciels.

D'autres éléments peuvent servir d'indicateurs :

service

→ On n'utilise plus service (upstart / system V). On lui préfère systemctl (systemd) depuis 2016.

pulseaudio

ou

pa-*

→ Ubuntu n'utilise plus pulseaudio mais pipewire.

pareil pour

jackd

ou

qjackctl

→ on n'utilise plus JACK mais pipewire.

(…et une documentation qui conseille de désinstaller pipewire ne mérite probablement pas d'être suivie.)

apt-get

→ Un autre bon indicateur de la péremption du truc : apt-get (encore valable mais seulement pour des scripts) au lieu de apt

D'une manière générale évitez autant que possible de copier-coller une commande sans la comprendre. Si la commande n'est pas expliquée prenez du temps pour comprendre au moins le premier terme, qui correspond au nom de l'application ou de l'action qu'on va effectuer.

Les lignes de commandes ne sont pas des formules magiques, le rédacteur d'une documentation se doit de les rendre un minimum compréhensibles.

Par ex. :

Nous allons changer les permissions du répertoire test :

chmod 755 ~/test

Évitez en particulier de mélanger plusieurs documentations parce que l'une n'a pas fonctionné, si vous n'êtes pas sûr·e d'avoir rétabli votre configuration d'origine. Il peut exister de nombreuses approches différentes pour un même problème.

Il est très rarement indispensable de modifier des répertoires ou des fichiers du système, en particulier si on est seul à utiliser son ordinateur. Ces ressources sont tous les répertoires à la racine du système, en dehors de votre répertoire personnel /home/nom_d'utilisateur qui correspond à ~.

On peut installer manuellement des packs d'icônes, des thèmes ou même des binaires exécutables dans son répertoire personnel.

Le répertoire ~/.local sert à surcharger moins dangereusement les ressources générales.

Les modifications manuelles des répertoires système sont une activité avancée d'administrateur système. Il est par exemple utile de modifier des fichiers dans /srv ou /var/www si vous utilisez ubuntu comme un serveur.

sudo gedit

→ Problématiques liées à l'édition des fichiers système via une application graphique

En ajoutant un PPA, vous ouvrez la porte de votre ordinateur à des inconnus.¹⁾²⁾

Si une documentation vous propose d'exécuter un add-apt-repository sans la moindre mise en garde, elle n'est probablement pas digne d'être suivie.

  add-apt-repository ppa:nilarimogard/webupd8

→ Dépôts fourre-tout qui n'ont aucunes raison d'être, et qui anéantissent la fiabilité d'Ubuntu. Il existe d'autre méthodes bien plus propres pour utiliser des logiciels qui ne sont pas disponibles dans les dépôts officiels :³⁾

• appimage
• flatpak
• snap
• distrobox

add-apt-repository ppa:ondrej/apache2

ou

add-apt-repository ppa:ondrej/php

→ évitez d'avoir recours au PPA d'ondrej sury !

Les outils prétendant "nettoyer" Ubuntu, tels que Bleachbit ou Stacer, s'avèrent souvent plus problématiques qu'utiles.

Voir plutôt la page concernant l'entretien d'Ubuntu.

• De la même manière, si vous ne comprenez pas ce que vous faites, ne le faites pas, et prenez 5 minutes pour demander des explications sur le forum.

• Les tutoriels et astuces censées augmenter la durée de vie des SSD sont au mieux inutiles, et risquent seulement de ralentir fortement votre système, ou de lui faire perdre certaines fonctionnalités utiles !
  Voir Utilisation avec Ubuntu.

Il existe de grosses différences d'une distribution à une autre, ou même d'une version à l'autre d'une même distribution. À moins de très bien connaître l'environnement Linux, il est très compliqué de savoir quelles sont les informations pertinentes nous concernant.

Debian est très bien documenté, et proche d'Ubuntu, mais référez-vous toujours à ce wiki en priorité.

Pop!_OS et Linux Mint (basés sur Ubuntu) fournissent peu de documentation, et pour ces systèmes celle du wiki Ubuntu ne sera pas toujours adaptée.

Arch est aussi très bien documenté, mais son environnement est très différent. On ne pourra donc que picorer des informations pour certains logiciels précis.

• Les commandes dangereuses

Contributeurs : krodelabestiole