mirror of https://github.com/ditkrg/rswag.git synced 2026-01-23 06:16:42 +00:00

we wish to make it easier to know what to expect as a contributor.
That is we want semantic versioning, and we want you to know that contributions are valuable, and that as a contributor you don't own anyone anything so there's no pressure.

2020-03-27 00:16:07 +00:00

1.2 KiB

Raw Blame History

Contributing

🎉 Thanks for taking the time to contribute! 🎉

We put forward the philosophy put forward by the react community about ownership, responsibility and avoiding burnout.

We also strive to achieve semantic versioning for this repo.

Fork, then clone the repo:

git clone git@github.com:rswag/rswag.git
cd rswag

Build

Set up your machine:

./ci/build.sh

Or manually

bundle
cd test-app
bundle exec rake db:setup
cd -

cd rswag-ui
npm install
cd -

Test

Make sure the tests pass:

./ci/test.sh

or manually

cd test-app
bundle exec rspec

Make your change. Add tests for your change. Make the tests pass:

bundle exec rspec

Push to your fork and submit a Pull Request.

Release

(for maintainers)

Update the changelog.md, putting the new version number in and moving the Unreleased marker.

Merge the changes into master you wish to release.

Add and push a new git tag, annotated tags preferred:

git tag -s 2.0.6 -m 'v2.0.6'

Travis will detect the tag and release all gems with that tag version number.