%% licence RAFRAB(*)
%%
%% RAFRAB : rien à f**tre, rien à battre, fais ce qu'il te plait dans la vie
%%


\documentclass[french]{beamer}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usetheme{Warsaw}

\title{Linux : où trouver la documentation ?}
\author{}\institute{Agence universitaire de la Francophonie}

\begin{document}

\begin{frame}
\titlepage
\end{frame}

\section{Généralement}
\frame{\tableofcontents[current]}

\begin{frame}
Sur le système, les pages de \texttt{man}
\begin{itemize}
\item le format d'une page de manuel : \texttt{NAME}, \texttt{SYNOPSIS}, \texttt{DESCRIPTION},  \texttt{OPTIONS}, \texttt{FILES}, \texttt{SEE ALSO}, \texttt{BUGS}, ...
\item \texttt{man man} : les différentes sections. En cas d'ambiguité, on précise : \texttt{man 1 crontab} ou \texttt{man 5 crontab}
\item \texttt{whatis} et \texttt{apropos}
\item en français : paquet \texttt{manpages-fr}
\item le système \texttt{info}
\end{itemize}
\end{frame}

\begin{frame}
Sur le web : à boire et à manger !
\begin{itemize}
\item Les grands sites de documentations \textbf{validées} : \url{tldp.org} et \texttt{traduc.org}, \url{linux-france.fr}, ...
\item Les sites «constructeurs» : \url{www.debian.org}, \url{help.ubuntu.com}, ...
\item Les sites des logiciels : \url{www.apache.org}, \url{www.php.net}, ...
\item Attention : aux sites \textit{wiki} publics, aux forums (par mail, sur le web ou sur les news), aux blogs et autres sites personels.
\item Message de la francophonie : préférer la version anglaise, souvent plus à jour que les traductions.
\item Exemples où la prudence est de mise : \texttt{doc.ubuntu-fr.org}, \texttt{www.php.net} et ses forums, les résultats de Google, etc.
\end{itemize}
\end{frame}

\begin{frame}
Quelques autres sources :
\begin{itemize}
\item Les listes de \textit{diffusion}, notamment les listes d'annonces concernant un logiciel ou un thème (sécurité)
\item Les flux (RSS ou Atom) : c'est du web, on y trouve encore à boire et à manger.
\item Les RFC, les FAQS (\url{http://www.faqs.org}
\item Les livres : chers, très rarement à jour (surtout en cas de traduction), qualité inégale. Quelques collections se détachent du lot.
\item Les canaux IRC, les listes de discussion, les forums USENET...
\end{itemize}
\end{frame}

\begin{frame}
Au secours je suis perdu, aidez moi !
\begin{itemize}
\item Comment poser les questions de manière intelligente
\item \url{http://www.linux-france.org/article/these/smart-questions/smart-questions-fr.html}
\end{itemize}
\end{frame}

\section{Documentations orientées Debian} 
\frame{\tableofcontents[current]}

\begin{frame}
Sur un système Debian : \texttt{/usr/share/doc/\textit{logiciel}}
\begin{itemize}
\item Gros avantage : c'est la documentation de la version installée du logiciel
\item \texttt{README.Debian} : le premier reflexe après avoir installé un paquet
\item \texttt{NEWS.Debian}
\item \texttt{changelog.Debian} 
\item Note : pour lire des fichiers \texttt{.gz}, utiliser \texttt{zless}
\item Note : parfois présence d'un paquet \texttt{\textit{logiciel}-doc}
\end{itemize}
\end{frame}

\begin{frame}
Les sites web Debian
\begin{itemize}
\item \url{www.debian.org} : une mine d'information
\item \url{packages.debian.org}
\item \url{bugs.debian.org} : suis-je le seul à avoir ce problème ? (Si oui : \texttt{reportbug})
\item \url{security.debian.org} et la liste de diffusion DSA
\item \url{packages.qa.debian.org}
\item \url{help.ubuntu.com} : plus simple d'accès, mais pas tout à fait Debian (il peut y avoir des différences éventuellement subtiles)
\end{itemize}
\end{frame}

\section{Les docs de l'AUF} 
\frame{\tableofcontents[current]}

\begin{frame}
\begin{itemize}
\item Un outil public, le wiki des techniciens : \url{http://wiki.auf.org/wikiteki} (et son flux RSS)
\item Outils de communication internes : listes de discussion/diffusion, messagerie instantannée (avec possibilité de conférence), VoIP et visio-conférence, lettres d'information, pauses café, ...
\item Certains outils internes sont accessibles au public par cooptation
\end{itemize}
\end{frame}

\section{et OpenVZ ?} 
\frame{\tableofcontents[current]}

\begin{frame}
\begin{itemize}
\item \url{www.openvz.org} : un wiki... donc attention (vérifier les dates)
\item mais : une doc de référence en PDF
\item mais : des pages de man très bien faites (\texttt{vzctl}, \texttt{vps.conf}, ...)
\end{itemize}
\end{frame}

\end{document}
