[svnbook] r3672 committed - * src/fr/book/foreword.xml...
svnbook at googlecode.com
svnbook at googlecode.com
Sun Jan 24 15:01:45 CST 2010
Revision: 3672
Author: subversif999 at gmail.com
Date: Sun Jan 24 13:00:50 2010
Log: * src/fr/book/foreword.xml
- Translate Foreword
http://code.google.com/p/svnbook/source/detail?r=3672
Modified:
/trunk/src/fr/book/foreword.xml
=======================================
--- /trunk/src/fr/book/foreword.xml Sat Aug 2 08:38:01 2008
+++ /trunk/src/fr/book/foreword.xml Sun Jan 24 13:00:50 2010
@@ -10,118 +10,128 @@
<firstname>Karl</firstname>
<surname>Fogel</surname>
</author>
- <pubdate>Chicago, March 14, 2004.</pubdate>
+ <pubdate>Chicago, le 14 mars 2004.</pubdate>
</prefaceinfo>
- <title>Foreword</title>
-
- <para>A bad Frequently Asked Questions (FAQ) sheet is one that is
- composed not of the questions people actually ask, but of the
- questions the FAQ's author <emphasis>wishes</emphasis> people
- would ask. Perhaps you've seen the type before:</para>
+ <title>Avant-propos</title>
+
+ <para>Une mauvaise FAQ est composée non pas des questions que
+ posent les utilisateurs, mais de celles que l'auteur de la FAQ
+ <emphasis>voudrait</emphasis> qu'on lui pose. Peut-être
+ avez-vous rencontré ce type de FAQ :</para>
<blockquote>
- <para>Q: How can I use Glorbosoft XYZ to maximize team
- productivity?</para>
+ <para>Q : Comment peut-on utiliser Glorbosoft XYZ pour
+ maximiser la productivité de nos équipes ?</para>
</blockquote>
<blockquote>
- <para>A: Many of our customers want to know how they can
- maximize productivity through our patented office groupware
- innovations. The answer is simple. First, click on the
- <literal>File</literal> menu, scroll down to
- <literal>Increase Productivity</literal>,
- then…</para>
+ <para>R : Beaucoup de nos clients veulent savoir comment
+ maximiser la productivité avec notre nouvelle suite bureautique
+ brevetée. La réponse est simple : cliquez sur le menu
+ <literal>Fichier</literal>, puis trouvez
+ <literal>Améliorer la productivité</literal> plus bas,
+ ensuite…</para>
</blockquote>
- <para>The problem with such FAQs is that they are not, in a
- literal sense, FAQs at all. No one ever called the tech support
- line and asked, <quote>How can we maximize
- productivity?</quote> Rather, people asked highly specific
- questions, such as <quote>How can we change the calendaring system
- to send reminders two days in advance instead of one?</quote>
- and so on. But it's a lot easier to make up imaginary
- Frequently Asked Questions than it is to discover the real ones.
- Compiling a true FAQ sheet requires a sustained, organized
- effort: over the lifetime of the software, incoming questions
- must be tracked, responses monitored, and all gathered into a
- coherent, searchable whole that reflects the collective
- experience of users in the wild. It calls for the patient,
- observant attitude of a field naturalist. No grand
- hypothesizing, no visionary pronouncements here—open eyes
- and accurate note-taking are what's needed most.</para>
-
- <para>What I love about this book is that it grew out of just such
- a process, and shows it on every page. It is the direct result
- of the authors' encounters with users. It began with Ben
- Collins-Sussman's observation that people were asking the same
- basic questions over and over on the Subversion mailing lists:
- what are the standard workflows to use with Subversion? Do
- branches and tags work the same way as in other version control
- systems? How can I find out who made a particular change?</para>
-
- <para>Frustrated at seeing the same questions day after day, Ben
- worked intensely over a month in the summer of 2002 to write
- <citetitle>The Subversion Handbook</citetitle>, a 60-page
- manual that covered all the basics of using Subversion. The
- manual made no pretense of being complete, but it was
- distributed with Subversion and got users over that initial hump
- in the learning curve. When O'Reilly decided to
- publish a full-length Subversion book, the path of least
- resistance was obvious: just expand the Subversion
- handbook.</para>
-
- <para>The three coauthors of the new book were thus presented
- with an unusual opportunity. Officially, their task was to
- write a book top-down, starting from a table of contents and an
- initial draft. But they also had access to a steady
- stream—indeed, an uncontrollable geyser—of bottom-up
- source material. Subversion was already in the hands of
- thousands of early adopters, and those users were giving tons of
- feedback, not only about Subversion, but also about its existing
- documentation.</para>
-
- <para>During the entire time they wrote this book, Ben, Mike, and
- Brian haunted the Subversion mailing lists and chat rooms
- incessantly, carefully noting the problems users were having in
- real-life situations. Monitoring such feedback was part of their
- job descriptions at CollabNet anyway, and it gave them a huge
- advantage when they set out to document Subversion. The book
- they produced is grounded firmly in the bedrock of experience,
- not in the shifting sands of wishful thinking; it combines the
- best aspects of user manual and FAQ sheet. This duality might
- not be noticeable on a first reading. Taken in order, front to
- back, the book is simply a straightforward description of a
- piece of software. There's the overview, the obligatory guided
- tour, the chapter on administrative configuration, some advanced
- topics, and of course, a command reference and troubleshooting
- guide. Only when you come back to it later, seeking the
- solution to some specific problem, does its authenticity shine
- out: the telling details that can only result from encounters
- with the unexpected, the examples honed from genuine use cases,
- and most of all the sensitivity to the user's needs and the
- user's point of view.</para>
-
- <para>Of course, no one can promise that this book will answer
- every question you have about Subversion. Sometimes the
- precision with which it anticipates your questions will seem
- eerily telepathic; yet occasionally, you will stumble into a
- hole in the community's knowledge and come away empty-handed.
- When this happens, the best thing you can do is email
- <email>users at subversion.tigris.org</email> and present your
- problem. The authors are still there and still watching, and the
- authors include not just the three listed on the cover, but many others
- who contributed corrections and original material. From the
- community's point of view, solving your problem is merely a
- pleasant side effect of a much larger project—namely,
- slowly adjusting this book, and ultimately Subversion itself, to
- more closely match the way people actually use it. They are
- eager to hear from you, not only because they can help you, but
- because you can help them. With Subversion, as with all active
- free software projects, <emphasis>you are not
- alone</emphasis>.</para>
-
- <para>Let this book be your first companion.</para>
+ <para>Le problème avec de telles FAQ, c'est qu'elles ne sont pas du
+ tout, au sens propre, des FAQ. Personne n'a appelé le support
+ technique et demandé <quote>Comment pouvons-nous améliorer la
+ productivité ?</quote> Au lieu de ça, les gens posent des
+ questions très précises, telles que <quote>Comment pouvons-nous
+ configurer le système de calendrier pour envoyer les rappels deux
+ jours en avance au lieu de 24 heures ?</quote> etc. Hélas, il
+ est tellement plus facile d'imaginer des questions que de trouver
+ celles qui sont vraiment fréquemment posées. Rédiger une vraie FAQ
+ requiert un effort continu et une bonne organisation : tout
+ au long de la vie du logiciel, les questions posées ainsi que
+ leurs réponses doivent être suivies de près, puis rassemblées et
+ organisées de façon claire et cohérente dans un tout qui doit
+ refléter l'expérience des utilisateurs. Cela nécessite d'être
+ patient et observateur, tel un naturaliste. Ici, pas de grandes
+ théories ni de discours visionnaires, ce qu'il faut avant tout,
+ c'est ouvrir les yeux et prendre des notes.</para>
+
+ <para>Ce que j'aime à propos de ce livre, c'est qu'il a été créé en
+ suivant ce procédé, ce qui se ressent à chacune de ses pages.
+ C'est le résultat direct de la rencontre des auteurs et des
+ utilisateurs. Tout a commencé lorsque Ben Collins-Sussman remarqua
+ que les gens posaient constamment les mêmes questions de base sur
+ la liste de diffusion de Subversion : Quelles sont les procédures
+ pour travailler avec Subversion ? Est-ce que les branches et les
+ étiquettes fonctionnent comme dans les autres systèmes de gestion
+ de versions ? Comment est-ce que je peux trouver qui a fait telle
+ ou telle modification ?</para>
+
+ <para>Frustré de voir revenir les mêmes questions jour après jour,
+ Ben travailla d'arrache-pied pendant un mois durant l'été 2002
+ pour écrire <citetitle>The Subversion Handbook</citetitle>, un
+ manuel de soixante pages couvrant toutes les bases de Subversion.
+ Le manuel ainsi écrit n'avait pas la prétention d'être complet,
+ mais il fut distribué avec Subversion pour aider les utilisateurs
+ à faire leurs premiers pas dans l'apprentissage de Subversion.
+ Quand O'Reilly and Associates décidèrent de publier un livre
+ complet sur Subversion, la voie la plus facile était la plus
+ évidente : simplement améliorer <citetitle>The Subversion
+ Handbook</citetitle>.</para>
+
+ <para>Une opportunité inhabituelle se présenta donc aux trois
+ co-auteurs de ce nouveau livre. Officiellement, leur tâche était
+ d'écrire un livre <quote>académique</quote>, en partant d'une
+ table des matières et d'une première ébauche. Mais ils avaient
+ aussi accès à un flux constant, une quantité incontrôlable en
+ fait, de réactions en provenance des utilisateurs. Subversion
+ était déjà entre les mains de quelques milliers d'utilisateurs
+ précoces, et ces derniers envoyaient des tonnes de commentaires,
+ pas seulement sur Subversion, mais aussi sur sa documentation
+ d'alors.</para>
+
+ <para>Pendant que Ben, Mike et Brian écrivaient ce livre, ils
+ surveillèrent sans relâche la liste de diffusion et les salons de
+ discussion de Subversion, notant consciencieusement les problèmes
+ que rencontraient les utilisateurs dans la réalité. Assurer le
+ suivi de ces retours d'expériences faisait de toutes façons partie
+ intégrante de leur travail à CollabNet, et cela leur donna un
+ énorme avantage quand ils commencèrent à rédiger la documentation
+ de Subversion. Le livre qu'ils ont écrit repose sur un socle
+ d'expérience pratique, pas sur une liste abstraite de bonnes
+ intentions ; il possède à la fois les qualités du mode d'emploi
+ et de la FAQ. Cette dualité ne saute pas immédiatement aux yeux.
+ Lu dans l'ordre, de la première à la dernière page, ce livre
+ décrit de manière simple un logiciel. Il y a la vue d'ensemble,
+ l'incontournable visite guidée, le chapitre sur la configuration
+ et l'administration, quelques sujets avancés, et bien évidemment
+ une liste complète des commandes ainsi qu'un guide de débogage.
+ Mais c'est quand on revient chercher dans ce livre une réponse à
+ un problème spécifique qu'on réalise son authenticité, faite de
+ détails révélateurs ne pouvant provenir que de cas concrets et
+ inattendus, d'exemples tirés de situations réelles, et par-dessus
+ tout de l'attention portée aux besoins et aux remarques des
+ utilisateurs.</para>
+
+ <para>Bien sûr, personne ne peut affirmer que ce livre répondra à
+ toutes vos questions sur Subversion. De temps en temps, la
+ précision avec laquelle il anticipe vos questions vous semblera
+ presque télépathique ; mais d'autres fois, vous tomberez sur
+ une lacune dans le savoir de la communauté, et vous rentrerez
+ bredouille. Quand cela arrive, le mieux que vous puissiez faire
+ est d'envoyer un courrier électronique à
+ <email>users at subversion.tigris.org</email>
+ (en anglais si possible) en y décrivant votre
+ problème. Les auteurs sont toujours là, à l'affût, et il ne s'agit
+ pas seulement des trois personnes citées sur la couverture du
+ livre, mais aussi de beaucoup d'autres contributeurs ayant
+ apporté corrections et améliorations. Pour la communauté, résoudre
+ votre problème est une composante agréable d'un projet bien plus
+ vaste, celui de peaufiner petit à petit ce livre, et finalement
+ Subversion lui-même, pour encore mieux coller à l'utilisation que
+ les gens en ont. Les auteurs sont très enthousiastes à l'idée de
+ communiquer avec vous, pas seulement parce qu'ils peuvent vous
+ aider, mais aussi parce que vous pouvez les aider. Avec Subversion,
+ comme avec tous les projets de logiciels libres en activité,
+ <emphasis>vous n'êtes pas seul</emphasis>.</para>
+
+ <para>Ce livre est votre premier compagnon.</para>
</preface>
More information about the svnbook-dev
mailing list