CONTRIBUTING.md

CONTRIBUTING

Releasing to testing

To test one of your jemquarie branches, follow these steps:

1. Merge your branch my_branch (feature or bugfix) into testing:

   # in jemquarie
   git checkout testing
   git merge my_branch

2. Update the testing branch in investapp:

   # in investapp
   git checkout testing
   bundle update jemquarie --conservative
   git commit -am "Update jemquarie testing branch"
   git push

3. Deploy to testing

Releasing to production

To release a new version of the jemquarie gem follow this checklist:

1. Merge your branch (feature or bugfix) into master:

   # in jemquarie
   git checkout master
   git merge my_branch

2. Bump the version (e.g. to 1.6.0) using semantic versioning

   # in jemquarie
   vi lib/jemquarie/version.rb
   
   # change version and describe your changes
   vi CHANGELOG.md
   
   git commit -m "Bump version to 1.6.0" -a

   It is strongly recommended to change version and changelog on release only to avoid merge conflicts during development.

3. Push your changes

   git push

4. Update the gem in the investapp

   cd investapp
   bundle update jemquarie
   # make sure the released version matches
   git commit -m "Update the jemquarie gem to its latest version 1.6.0" -a
   git push

5. Deploy the investapp

6. Merge into testing

   # in investapp
   git checkout testing
   git merge master
   # resolve any conflicts
   # maybe deploy to testing

Code of Conduct

See CODE_OF_CONDUCT.