From a7b369691d28becacc849364eec4a3f95efe3475 Mon Sep 17 00:00:00 2001
From: cake17 <cake17@cake-websites.com>
Date: Mon, 30 Mar 2015 20:09:20 +0200
Subject: [PATCH] [fr] #2571 & #2550

---
 en/controllers/components/authentication.rst |  1 +
 fr/contributing/documentation.rst            | 72 ++++++++++++++++++--
 fr/controllers/components/authentication.rst |  2 +
 3 files changed, 70 insertions(+), 5 deletions(-)

diff --git a/en/controllers/components/authentication.rst b/en/controllers/components/authentication.rst
index e4afee283f..a8695fe650 100644
--- a/en/controllers/components/authentication.rst
+++ b/en/controllers/components/authentication.rst
@@ -245,6 +245,7 @@ you wanted to create an OpenID authentication object. In
 **src/Auth/OpenidAuthenticate.php** you could put the following::
 
     namespace App\Auth;
+
     use Cake\Auth\BaseAuthenticate;
 
     class OpenidAuthenticate extends BaseAuthenticate
diff --git a/fr/contributing/documentation.rst b/fr/contributing/documentation.rst
index 891aee05f8..af7467a0cf 100755
--- a/fr/contributing/documentation.rst
+++ b/fr/contributing/documentation.rst
@@ -9,10 +9,11 @@ les fichiers -- le bouton "Improve this Doc" (Améliorer cette Doc) sur toutes
 les pages vous redirigera vers l'éditeur en ligne de Github pour la page
 correspondante.
 
-CakePHP documentation is
-`continuously integrated <http://en.wikipedia.org/wiki/Continuous_integration>`_,
-so you can check the status of the `various builds <http://ci.cakephp.org>`_
-on the Jenkins server at any time.
+La documentation de CakePHP est `intégrée de façon continue
+<http://en.wikipedia.org/wiki/Continuous_integration>`_,
+donc vous pouvez vérifier le statut des
+`différents builds <http://ci.cakephp.org>`_
+sur le serveur Jenkins à tout moment.
 
 Traductions
 ===========
@@ -21,7 +22,68 @@ Envoyez un Email à l'équipe docs (docs at cakephp dot org) ou venez
 discuter sur IRC (#cakephp on freenode) de tout effort de traduction auquel
 vous souhaitez participer.
 
-Astuces de traducteurs:
+Nouvelle Traduction d'une Langue
+--------------------------------
+
+Nous souhaitons créer des traductions aussi complètes que possible. Cependant,
+il peut arriver des fois où un fichier de traduction n'est pas à jour. Vous
+devriez toujours considérer la version anglais comme la version qui fait
+autorité.
+
+Si votre langue n'est pas dans les langues actuellement proposées, merci de
+nous contacter sur Github et nous envisagerons de créer un squelette de dossier
+pour cette langue. Les sections suivantes sont les premières par lesquelles vous
+devriez commencer puisque ce sont des fichiers qui ne changent pas souvent:
+
+- index.rst
+- intro.rst
+- quickstart.rst
+- installation.rst
+- dossier /intro
+- dossier /tutorials-and-examples
+
+Note pour les Administrateurs de la Doc
+---------------------------------------
+
+La structure de tous les dossiers de langue doivent refléter la structure du
+dossier anglais. Si la structure change pour la version anglaise, nous devrions
+appliquer ces changements dans les autres langues.
+
+Par exemple, si un nouveau fichier anglais est créé dans **en/file.rst**, nous
+devrions:
+
+- Ajouter le fichier dans les autres langues : **fr/file.rst**, **zh/file.rst**, ...
+- Supprimer le contenu, mais en gardant les ``title``, informations ``meta``
+  et d'éventuels éléments ``toc-tree``. La note suivante sera ajoutée en anglais
+  tant que personne n'a transmis le fichier::
+
+    File Title
+    ##########
+
+    .. note::
+        The documentation is not currently supported in XX language for this
+        page.
+
+        Please feel free to send us a pull request on
+        `Github <https://github.com/cakephp/docs>`_ or use the **Improve This Doc**
+        button to directly propose your changes.
+
+        You can refer to the English version in the select top menu to have
+        information about this page's topic.
+
+    // If toc-tree elements are in the English version
+    .. toctree::
+        :maxdepth: 1
+
+        one-toc-file
+        other-toc-file
+
+    .. meta::
+        :title lang=xx: File Title
+        :keywords lang=xx: title, description,...
+
+Astuces de traducteurs
+----------------------
 
 - Parcourez et modifiez le contenu à traduire dans le langage voulu - sinon
   vous ne verrez pas ce qui a déjà été traduit.
diff --git a/fr/controllers/components/authentication.rst b/fr/controllers/components/authentication.rst
index 5eb4248ec1..df2ac8196b 100644
--- a/fr/controllers/components/authentication.rst
+++ b/fr/controllers/components/authentication.rst
@@ -266,6 +266,8 @@ objets d'authentification personnalisés pour votre application ou plugins.
 Si par exemple vous vouliez créer un objet d'authentification OpenID, dans
 **src/Auth/OpenidAuthenticate.php**, vous pourriez mettre ce qui suit::
 
+    namespace App\Auth;
+
     use Cake\Auth\BaseAuthenticate;
 
     class OpenidAuthenticate extends BaseAuthenticate