mirror of
https://github.com/ditkrg/rswag.git
synced 2026-01-22 22:06:43 +00:00
73 lines
1.2 KiB
Markdown
73 lines
1.2 KiB
Markdown
# Contributing
|
|
|
|
## 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][pr].
|
|
|
|
[pr]: https://github.com/rswag/rswag/compare/
|
|
|
|
## Updating Swagger UI
|
|
|
|
Find the latest versions of swagger-ui here:
|
|
https://github.com/swagger-api/swagger-ui/releases
|
|
|
|
Update the swagger-ui-dist version in the rswag-ui dependencies
|
|
```
|
|
./rswag-ui/package.json
|
|
```
|
|
|
|
Navigate to the rswag-ui folder and run npm install to update the package-lock.json
|
|
|
|
|
|
## 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.
|