Website Development
How to contribute to the RCN Website
This site follows the Gitflow workflow
Branch Structure
- main -- Release branch from which the current, displayed website is generated
- develop -- Development branch where updates are aggregated between releases
- feature_branch_name - Feature branches should be forked off of develop, and should be named with a human readable intuitive name. Delete feature branches once merged into develop and work in them is complete.
We recommend that developers use the following workflow:
First, set up your working environment:
- Create a fork of the repository into your github account by clicking the Fork icon on the right top corner of the main github EPRV-RCN/RVdata repo page.
- Clone your fork to your local computer:
git clone git@github.com:YourGithubID/RVdata.git - Setup a new remote named upstream that points to the project level repository:
git remote add upstream git@github.com:EPRV-RCN/RVdata.git
To add a new feature or bugfix to the website:
- Create a feature branch off of develop for your new work. Bugfix branches should prefix with bugfix
- Make your changes, commit them with a useful commit message, and push to your fork.
- Setup a pull request from your feature branch into the project level develop branch. Use the Pull requests menu item on the top bar of github.com. Be sure that the pull request points into the EPRV-RCN.github.io develop branch. This will trigger a review request.
- Iterate with reviewers as needed, using the pull request to capture discussion comments. Once the reviewers approve the pull request, the original author is responsible for merging.
git checkout -b feature_branch_name
git commit -m "Description of committed changes" git push origin feature_branch_name
If you encounter a merge conflict, ask for help. Do not proceed!