Thank you for considering contributing to this bundle. We welcome any kind of contribution, no matter if its huge or small, about documentation or code. We also welcome any kind of developers, from experts to people who just started working on Open-Source projects.
Before your first contribution, make sure you'll meet these requirements:
- You have a user account on GitHub.
- You have installed in your computer a working environment to develop PHP applications.
- You have a basic level of English (code, docs and discussions are in English).
All submitted contributions (both code and documentation) adhere implicitly to the Open-Source MIT License.
Proposing New Features
We are determined to maintain the original simple and pragmatic philosophy of the bundle. This means that we routinely reject any feature that complicates the code too much or which doesn't fit in the bundle's philosophy.
That's why we strongly recommend you to propose new features by opening a new issue in the repository to discuss about them instead of submitting a pull request with the code of the proposed feature.
- Go to the list of EasyAdmin issues and look for any existing bug similar to yours.
- If the bug hasn't been reported yet, create a new issue and
provide the following information:
- Short but precise description of the bug (attach screenshots if needed);
- Symfony version used (because we support both 2.x and 3.x versions);
- EasyAdmin version (if it's not the latest one).
Sending Pull Requests
Making your changes
Fork the EasyAdmin repository on GitHub and clone it in your computer:
bash $ git clone git://github.com/<YOUR GITHUB USERNAME>/EasyAdminBundle.git
Create a new branch for the new code (if you are fixing a bug, you can call this branch
NNNis the number of the related issue):
bash $ git checkout -b fix_NNN
Make your code changes (use the same code syntax as Symfony described in PSR-2) and submit the changes. Make sure that your code is compatible with PHP 5.3 and Symfony 2.3. Sometimes it's tricky to develop code compatible with Symfony 2.3 and 3.x. If you get stuck, just ask us and we'll help you.
Submitting your changes
Commit and push your changes to your own fork:
optional: needed only if you have added new files
$ git add --all
$ git commit path/to/modified/files
alternative: "git commit -a" to commit all the modified files
if this doesn't work, try: "git push origin
$ git push ```
Go to the GitHub website and create a new pull request in the EasyAdmin repository.
- Provide a short description about the changes made by the pull request.
If you are fixing a bug, add the text
Fixed #NNNand provide the number of the related issue (this allows us to track which bugs have already been fixed).
- There is no need to "squash" your commits. We'll do that for you.
In case some changes are merged in the repository since you submitted your pull request, we may ask you to rebase it to make it mergeable again:
$ git remote add upstream email@example.com:javiereguiluz/EasyAdminBundle.git $ git pull --rebase upstream master $ git push -f origin the_name_of_your_branch