mirror of
https://github.com/puma/puma.git
synced 2022-11-09 13:48:40 -05:00
Update CONTRIBUTING.md (#2612)
This commit is contained in:
parent
fac83ae35a
commit
d97688f8cc
1 changed files with 16 additions and 1 deletions
|
@ -44,6 +44,13 @@ Linux:
|
|||
apt-get install ragel
|
||||
```
|
||||
|
||||
Windows (Ruby 2.5 and later):
|
||||
```sh
|
||||
ridk exec pacman -S mingw-w64-x86_64-openssl mingw-w64-x86_64-ragel
|
||||
```
|
||||
|
||||
**Note:** For all of the following commands you should be in your fork's directory.
|
||||
|
||||
Install Ruby dependencies with:
|
||||
|
||||
```sh
|
||||
|
@ -55,13 +62,19 @@ bundle install
|
|||
To run Puma, you will need to compile the native extension. To do this:
|
||||
|
||||
```sh
|
||||
# Ubuntu, macOS, etc
|
||||
bundle exec rake compile
|
||||
|
||||
# Windows
|
||||
bundle exec rake -rdevkit compile
|
||||
```
|
||||
|
||||
Then, you will be able to run Puma using your local copy with:
|
||||
|
||||
```sh
|
||||
bundle exec bin/puma test/rackup/hello.ru
|
||||
# -or-
|
||||
bundle exec ruby -Ilib bin/puma test/rackup/hello.ru
|
||||
```
|
||||
|
||||
Alternatively, you can reference your local copy in a project's `Gemfile`:
|
||||
|
@ -155,9 +168,11 @@ changelog ([`History.md`](History.md)), add the text `[changelog skip]` to the
|
|||
pull request title to skip [the changelog
|
||||
check](https://github.com/puma/puma/pull/1991).
|
||||
|
||||
Puma uses GitHub Actions for it's main CI testing. Please consider running the CI in your fork before creating a PR. A new repo (including forks) has Actions disabled. It can be set from the 'Setting' tab on your repo's web page.
|
||||
|
||||
## Backports
|
||||
|
||||
Puma does not have a backport "policy" - maintainers will not consistently backport bugfixes to previous minor or major versions (we do treat security differently, see [`SECURITY.md`](SECURITY.md).
|
||||
Puma does not have a backport "policy" - maintainers will not consistently backport bugfixes to previous minor or major versions (we do treat security differently, see [`SECURITY.md`](SECURITY.md).
|
||||
|
||||
As a contributor, you may make pull requests against `-stable` branches to backport fixes, and maintainers will release them once they're merged. For example, if you'd like to make a backport for 4.3.x, you can make a pull request against `4-3-stable`. If there is no appropriate branch for the release you'd like to backport against, please just open an issue and we'll make one for you.
|
||||
|
||||
|
|
Loading…
Add table
Reference in a new issue