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 ont été écrits avec sûrement de bonnes intentions, mais 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. Ce détail est malheureusement occulté la plupart du temps !
Cela peut mettre en danger les utilisateurs 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.

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

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ôt fourre-tout qui n'a aucune raison d'être. 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 !

Il existe de grosse 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 celle du wiki 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.

Contributeurs : krodelabestiole