You can visit our issue tracker at anytime to report bugs or make an enhancement requests.
If you come across a bug, where something isn't working properly or just doesn't seem right, please feel free to report them as a New Bug Report. Please be as clear as possible detailing your experience in order to best help us reproduce them. Other helpful information includes:
- List out any behaviors you weren't expecting to happen.
- Include screen shots of the issue, if possible.
- Give us your browser and version, if you think it's related.
We will do our best to read every issue that comes in, please be patient if we don't immediately take notice.
We also encourage code contributions via pull requests.
We also encourage our users to suggest new features or enhancement; please report them here: Feature Request or our discussions board.
We will do our best to read every request, however not all requests will be considered.
We appreciate any pull requests regarding fixing typos or bugs, however any new features or major change may be denied. This could be due to several reasons (i.e. it doesn't follow the current Roadmap), and the last thing we want to happen is for you to waste your valuable time; therefore, we encourage you to first suggest any ideas you have in our discussions board before pursuing it.
The following section will walk you through the process of getting setup to start submitting pull requests. You will need a GitHub account and a fork of FusionCMS.
Creating a Fork
- Click Fork in the upper-right corner of the FusionCMS repository.
- GitHub will make a copy of FusionCMS onto your account.
- You can then clone a copy of your fork on to your workstation.
The following is an outline of the process we use internally to submit pull requests. We recommend following the steps below to assure everything works as expected, although if you are confident in your skills you can do what works for you.
After cloning your fork of FusionCMS, you will need to configure a remote. This will allow you to sync changes from the original repository. We will refer to the original repository as
$ git remote add upstream <original-repository-url>
$ git remote add upstream firstname.lastname@example.org:fusioncms/cms.git
And, then to verify your remote was setup correctly:
$ git remote -v > origin email@example.com:your_account/cms.git (fetch) > origin firstname.lastname@example.org:your_account/cms.git (push) > upstream email@example.com:fusioncms/cms.git (fetch) > upstream firstname.lastname@example.org:fusioncms/cms.git (push)
For in-depth documentation read this.
Creating a Branch
First, make sure your
nightly branch is up to date.
$ git pull upstream nightly
If any updates come in, you may want to keep your
origin remote up to date.
$ git push origin nightly
Next, make a branch off of
nightly. Name your branch something that represents what you're trying to accomplish. The branch name should define a single goal you are trying to accomplish.
$ git checkout -b <branch-name>
Before pushing changes to your
origin remote, you will want to merge in any changes that may have occurred in the meantime on the original repository's
# Pull in any changes on nightly $ git checkout nightly $ git pull upstream nightly $ git push origin nightly # Switch to branch and merge any changes $ git checkout <branch-name> $ git merge nightly
Please resolve any conflicts that occurred and re-commit your changes. Once you have resolved any conflicts, you can then push your branch up to your
$ git push origin <branch-name>
This will push your changes to your Forked repository as a new branch. If you visit your forked repository you will notice a yellow banner has appeared asking if you would like to submit a pull request. Click create pull request button from the forked repository homepage.
Please detail the changes you made, provide screenshots if necessary, and reference any issues your pull request will resolve. Please allow time for a user with access to review your pull request. We will try to respond to any denied requests on why it was denied.
Refer to Coding Standards.
- All - at this time submit all pull requests to the beta release branch:
Have Further Questions?
You can always reach out to the development team through several sources listed below. We will try our best to get back to you with acknowledgement, further follow-up questions, and possibly a virtual high-five! :hand: