[TUTO] Contribuer à Presta sur GitHub

[Captain FLAM]

Bien, j'ouvre ce sujet afin de faire une synthèse de ce post : PrestaShop migre sous GitHub

 

► En 1er, lire la doc de Presta :

Norme de développement

Comment écrire un descriptif de modification

 

Les modifications se font (et vous devez aussi les faire) sur la branche "development"

 

► Les Outils (tous en open-source) :

 

► GitExtensions : code.google.com/p/gitextensions

FR - Win, Mac, Linux

- Mon préféré !!

avec 5 tutos en anglais

et livré avec une doc en PDF, sinon les docs sont aussi ici :

readthedocs.org/projects/git-extensions-documentation/downloads/

 

► Git : git-scm.com

EN - Win, Mac, Linux

- L'officiel développé par Linus (un peu vieillot à mon avis) : contient un bash pour windows et tous les outils git

 

► TortoiseGit : code.google.com/p/tortoisegit

FR - Win

- TortoiseGit - The coolest Interface to Git Version Control

là, il vous faudra installer celui-ci en 1er, et ensuite le précédent (Git ci-dessus)

 

► DBV : dbv.vizuina.com

PHP Web App

- dbv est un gestionnaire de versions dédié au versionning de bases de données.

 

 

► Documentations :

 

Et pour ceux que ça pourrait intéresser :

 

FR : git-scm.com/book/fr

EN : git-scm.com/book

 

Un livre très complet sur Git. Gratuit.

FR - Un lien m'a pas mal aidé mis à part le tuto de GraphikArt : yannesposito.com/Scratch/fr/blog/2009-11-12-Git-for-n00b

Merci !

EN - Pour mieux comprendre le fonctionnement de GitHub : help.github.com/articles/using-pull-requests

 

EN - un résumé des lignes de commande : www.eqqon.com/index.php/Collaborative_Github_Workflow

 

► Tuto vidéo :

 

J'ajoute à ça, pour les utilisateurs de windows (je suis gentil je pense à eux ), voici une vidéo tutoriel complète sur l'installation + manipulation de github : www.grafikart.fr/tutoriels/internet/git-github-131

 

► Tuto :

 

J'ai ajouté quelques commandes Git sur mon fork

 

github.com/alexsegura/1.5/tree/readme

 

Le mieux est de créer une branche par pull request. Celà permet de rendre les opérations plus atomiques.

 

En effet, vu que tous les changements de ton pull request seront dans une branche, ça te permet aussi de "corriger" ton pull request éventuellement, simplement en refaisant un push.

 

En gros, voici le workflow :

 

- Passer sur la branche development, éventuellement merger les derniers changements depuis le dépôt upstream, c'est à dire depuis la branche development du dépôt de PrestaShop.

- Créer une branche à partir de là

- Faire ses modifs

- Pousser la branche sur son fork.

- Créer un pull request via GitHub, avec pour source la branche.

- Etc..

 

En clair :

• une nouvelle branche (généralement "patch-xx") sur son propre Fork
  .
  
• un commit (y compris sur plusieurs fichiers) dans cette branche
  .
  
• un pull request vers "Prestashop/development" de cette branche
  

► Et pour Finir : AVANT de proposer vos modifs :

 

Installez les hooks de pre-commit permettant (normalement) de faire la validation des normes pour vous.

 

Téléchargez ce zip : github.com/PrestaShop/standard_coding_hook/archive/master.zip

 

Et décompressez son contenu sur votre disque dur dans le répertoire de votre Fork dans .git \ hooks

 

Exemple : C: \ Prestashop_GIT \ .git \ hooks

 

Edited August 2, 2013 by Captain FLAM (see edit history)

[indesign47]

Salut Captain,

 

Peux-tu rajouter ceci ? https://help.github....g-pull-requests Pour mieux comprendre le fonctionnent de GitHub

[Captain FLAM]

Fait !

[J. Danse]

Sous oublier les hooks de pre-commit permettant (normalement) de faire la validation des normes pour vous.

[Captain FLAM]

'ffectiv'ment ... J'avais oublié ce point ! Merci