
Contributing to Liferay Faces
The Liferay Faces project source code is contained in a Git repository hosted at GitHub. If you would like to make a contribution to the source code, here are some instructions:
1. Create an issue in the JIRA issue tracker for the FACES project. For example, see: FACES-1460
2. If you haven't done so already, create an account at GitHub.
3. Visit the following page with your browser and fork the liferay-faces project to your account:
https://github.com/liferay/liferay-faces
4. Clone the repository to your local hard drive:
git clone https://github.com/yourUserId/liferay-faces.git cd liferay-faces
5. Determine the branch that is most appropriate, and switch to that branch. For most software projects, contributions are done using the master branch, but this might not be appropriate for Liferay Faces. Currently, the master branch is designed for JSF 2.2 which has not yet been released by the JCP. So if you are using JSF 2.0/2.1 on Liferay 6.1, then it would be more appropriate to switch to the 3.1.x branch. For example:
git checkout 3.1.x
6. If you haven't done so already, then specify "upstream" as one of your remotes:
git remote add upstream https://github.com/liferay/liferay-faces.git
7. PLEASE KEEP YOUR FORK IN SYNC with upstream. For example:
git pull --rebase upstream 3.1.x git push origin 3.1.x
git branch FACES-1460
git checkout FACES-1460
git commit -a git push origin FACES-1460

