Sha256: d9848b2694e4dcca44f777049f223c5c3d0b05b3c58535bad57b2fb7e9cc323f

Contents?: true

Size: 1.79 KB

Versions: 24

Compression:

Stored size: 1.79 KB

Contents

---
layout: page
title: Contributing
---

<div id="toc">
# "How To Contribute":#contributing
# "Building From Source":#building
# "Documentation":#doc
# "Open Issues":#open
</div>

By all means.


h3(#contributing).  How To Contribute

Pick on an "open issue":http://github.com/assaf/vanity/issues, "experimental feature":experimental.html, or whatever you feel like contributing.

To contribute new code/changes:
# "Fork the project":http://github.com/assaf/vanity
# Please use a topic branch to make your changes, it's easier to test them that way
# Fix, patch, enhance, document, improve, sprinkle pixie dust
# Tests. Please. Run @rake@ and if possible CI (see below)
# Send a pull request on GitHub

Bonus points for helping improve the documentation, writing some examples, and adding more test coverage.


h3(#building). Building From Source

Vanity is tested against multiple Ruby implementations, and a variety of database engines. To make life easier, we use "RVM":http://rvm.beginrescueend.com/ and "Bundler":http://gembundler.com/ to set up the test/development environment.

To test Vanity for the first time under whichever Ruby implementation you're currently using:

<pre>
$ rake test:setup
$ rake
</pre>

To test Vanity with specific database adapter:

<pre>
$ rake DB=redis
$ rake DB=mongodb
$ rake DB=mysql
</pre>


Before making a release, we run the full test suite against multiple Ruby VMs and using multiple database adapters.  Doing this on your own is easier than it sounds:

# "Fork the project":http://github.com/assaf/vanity
# Go to "Travis CI":http://travis-ci.org/, setup a new account if you don't already have one
# "In your profile page":http://travis-ci.org/profile, tell Travis to build your fork
# @git push@ your changes into your fork and "watch Travis":http://travis-ci.org/ run the tests

Version data entries

24 entries across 24 versions & 1 rubygems

Version Path
vanity-4.0.4 doc/contributing.textile
vanity-4.0.3 doc/contributing.textile
vanity-4.0.2 doc/contributing.textile
vanity-4.0.1 doc/contributing.textile
vanity-4.0.0 doc/contributing.textile
vanity-3.1.0 doc/contributing.textile
vanity-3.0.2 doc/contributing.textile
vanity-3.0.1 doc/contributing.textile
vanity-3.0.0 doc/contributing.textile
vanity-2.2.10 doc/contributing.textile
vanity-2.2.9 doc/contributing.textile
vanity-2.2.8 doc/contributing.textile
vanity-2.2.7 doc/contributing.textile
vanity-2.2.6 doc/contributing.textile
vanity-2.2.4 doc/contributing.textile
vanity-2.2.3 doc/contributing.textile
vanity-2.2.2 doc/contributing.textile
vanity-2.2.1 doc/contributing.textile
vanity-2.2.0 doc/contributing.textile
vanity-2.1.2 doc/contributing.textile