utilisateurs:krodelabestiole:brouillons:documentation [Wiki ubuntu-fr]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{tag>débutant}}

====== 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...

===== vieux =====

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]] / [[:script_sysv|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 [[:jackd|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''

===== simplement mauvais =====

==== commande sans explication ====

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'' :
> <code>chmod 755 ~/test</code>

É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.

==== modification manuelle du systè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 [[:chemins#raccourcis_shell|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 graphique ====

  sudo gedit

-> [[:utilisateurs:aldian:sudo_gedit|Problématiques liées à l'édition des fichiers système via une application graphique]]

==== utilisation de PPA inutile, mal sécurisé, ou inadapté ====

En ajoutant un PPA, vous ouvrez la porte de votre ordinateur à des inconnus.((https://forum.ubuntu-fr.org/viewtopic.php?pid=21731638#p21731638))((https://forum.ubuntu-fr.org/viewtopic.php?pid=22023371#p22023371))

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.

=== webupd8 ===

    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 :((pour un comparatif : https://github.com/AppImage/AppImageKit/wiki/Similar-projects#comparison))
  * [[:appimage]]
  * [[:flatpak]]
  * [[:snap]]
  * [[:distrobox]]

=== ondrej ===

<code>add-apt-repository ppa:ondrej/apache2</code>
ou
<code>add-apt-repository ppa:ondrej/php</code>
-> [[:utilisateurs:krodelabestiole:sujets_recurrents#ondrej sury|évitez d'avoir recours au PPA d'ondrej sury !]]

===== inadapté =====

Il existe de grosse différences d'une [[:distributions|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.

===== Voir aussi =====

  * Les [[:commandes dangereuses]]

----

//Contributeurs : [[utilisateurs:krodelabestiole]]//