1
0
Fork 0
mirror of https://github.com/thoughtbot/factory_bot_rails.git synced 2022-11-09 11:49:18 -05:00

Add bin/setup, improve contributing guidelines

Move manual Appraisal tasks into bin/setup.
This commit is contained in:
Dan Croak 2014-05-26 20:43:06 -07:00
parent 39217eb028
commit 4defe4c666
2 changed files with 40 additions and 26 deletions

View file

@ -1,38 +1,36 @@
We love pull requests. Here's a quick guide: # Contributing
1. Fork the repo. We love pull requests. Here's a quick guide.
2. Run the tests. We only take pull requests with passing tests, and it's great Fork, then clone the repo:
to know that you have a clean slate: `bundle && rake`
3. Add a test for your change. Only refactoring and documentation changes git clone git@github.com:your-username/factory_girl_rails.git
require no new tests. If you are adding functionality or fixing a bug, we need
a test!
4. Make the test pass. Set up your machine:
5. Push to your fork and submit a pull request. ./bin/setup
Make sure the tests pass:
At this point you're waiting on us. We like to at least comment on, if not rake
accept, pull requests within three business days (and, typically, one business
day). We may suggest some changes or improvements or alternatives.
Some things that will increase the chance that your pull request is accepted, Make your change. Add tests for your change. Make the tests pass:
taken straight from the Ruby on Rails guide:
* Use Rails idioms and helpers rake
* Include tests that fail without your code, and pass with it
* Update the documentation, the surrounding one, examples elsewhere, guides,
whatever is affected by your contribution
Syntax: Push to your fork and [submit a pull request][pr].
* Two spaces, no tabs. [pr]: https://github.com/thoughtbot/factory_girl_rails/compare/
* No trailing whitespace. Blank lines should not have any space.
* Prefer &&/|| over and/or.
* MyClass.my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
* a = b and not a=b.
* Follow the conventions you see used in the source already.
And in case we didn't emphasize it enough: we love tests! At this point you're waiting on us. We like to at least comment on pull requests
within three business days (and, typically, one business day). We may suggest
some changes or improvements or alternatives.
Some things that will increase the chance that your pull request is accepted:
* Write tests.
* Follow our [style guide][style].
* Write a [good commit message][commit].
[style]: https://github.com/thoughtbot/guides/tree/master/style
[commit]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html

16
bin/setup Executable file
View file

@ -0,0 +1,16 @@
#!/usr/bin/env sh
# Run this script immediately after cloning the codebase.
# Exit if any subcommand fails
set -e
# Set up Ruby dependencies via Bundler
bundle install
# Add binstubs to PATH in ~/.zshenv like this:
# export PATH=".git/safe/../../bin:$PATH"
mkdir -p .git/safe
# Set up Appraisal to help us test against multiple Rails versions
bundle exec appraisal install