-
Notifications
You must be signed in to change notification settings - Fork 0
Guide de Contribution
CakePHP 3 sort bientôt et la documentation est en train d'être remaniée sur github. Je vais donc résumer dans ce post tout ce qu'il faut savoir pour traduire.
-
La modification de la documentation se fait sur https://github.com/cakephp/docs.
- CakePHP 2 : branche master
- CakePHP 3 : branche 3.0
-
L'affichage de la doc se trouve :
- CakePHP 2 http://book.cakephp.org/2.0/fr/index.html
- CakePHP 3 (en beta) http://book.cakephp.org/3.0/fr/index.html
Tout le monde peut contribuer à la traduction. Tous les avis sont les bienvenus alors n'hésitez pas à venir dans sur le forum ou sur IRC pour toutes vos questions se rapportant à la traduction. Le groupe github cakephp-fr regroupant les traducteurs se trouve ici. Si vous voulez en faire partie, demandez-le nous.
Ci-dessous les étapes pour participer à la traduction :
-
Installez GIT sur votre ordinateur http://git-scm.com/book/fr et inscrivez-vous gratuitement sur github https://github.com/signup/free. Vous pouvez aussi installer le logiciel avec interface graphique sur github dans la section téléchargements.
-
Forkez le dépôt officiel de la doc de cakephp ici. Forker veut dire faire une copie du dépôt de la doc officiel "cakephp / docs" sur le serveur de github mais à votre nom "votreNom / docs". Vous pourrez ainsi cloner votre dépôt (= récupérer les fichiers sur votre ordinateur) que vous venez de forker et le modifier sur votre ordinateur. Pusher vers votre dépôt et envoyez ensuite des pull request via le site de github.
-
Quand vous clonez votre dépôt sur votre ordinateur, toutes les branches sont normalement présentes. Dans le cas où la branche 3.0 n'est pas présente, vous pouvez faire ceci :
git checkout --track origin/3.0
Ça parait un peu compliqué au début, mais à long terme, ça vaut vraiment le coup d'utiliser git pour versionner ses projets. Accrochez-vous et ça coulera bientôt de source ! En plus la majorité des projets open source utilisent git et github, donc l'installation servira ! Plus d'aide
- http://openclassrooms.com/courses/gerer-son-code-avec-git-et-github
- https://help.github.com
- http://rogerdudler.github.io/git-guide/index.fr.html
Quelques règles pour bien traduire se trouvent ici. Par convention, vous pouvez ajouter [fr] au début de chaque nom de commit, et l'écrire en anglais, par exemple:
[fr] fix typo in save()