ruby-rcade/RubyGameDev.com

# RubyGameDev.com

RubyGameDev.com is a community-driven, information hub designed to help people build games in Ruby. This repository contains the source code that runs the RubyGameDev.com website. Please consider helping to improve our website.

## Ways that you can help:

* Suggest an improvement
* Report a bug
* Add a new feature
* Fix a bug
* Increase test coverage
* Improve this documentation

| Test Suite | TODO List | Chat Room |
|:----------:|:---------:|:---------:|
| [![Build Status](https://travis-ci.org/ruby-rcade/RubyGameDev.com.svg?branch=master)](https://travis-ci.org/ruby-rcade/RubyGameDev.com) [![Test Coverage](https://codeclimate.com/github/ruby-rcade/RubyGameDev.com/badges/coverage.svg)](https://codeclimate.com/github/ruby-rcade/RubyGameDev.com/coverage) [![Code Climate](https://codeclimate.com/github/ruby-rcade/RubyGameDev.com/badges/gpa.svg)](https://codeclimate.com/github/ruby-rcade/RubyGameDev.com) | [![Stories in Ready](https://badge.waffle.io/ruby-rcade/RubyGameDev.com.png?label=ready)](https://waffle.io/ruby-rcade/RubyGameDev.com) | [![Gitter Chat](http://img.shields.io/badge/chat-online-brightgreen.svg)](https://gitter.im/ruby-rcade/RubyGameDev.com?utm_source=badge&utm_medium=badge&utm_campaign=share-badge) |

## Table of Contents

* [Getting Started](#getting-started)
* [Writing Tests](#writing-tests)
* [Submitting a Pull Request](#submitting-a-pull-request)
* [Getting Help](#getting-help)

## Getting Started

This application is a Rails 4 application. The Ruby version requirement is listed in the `.ruby-version` file.

Begin by forking and cloning the repository to your local environment. Then install the gem dependencies:

```bash
$ cd RubyGameDev.com
$ bundle install
```

Create a database for your local environment by running the migrations:

```bash
$ bundle exec rake db:migrate
```

Then you can start the Rails server and see it running in your browser:

```bash
$ bundle exec rails server
```

If you would like to test GitHub authentication, you will need to install [Pow](http://pow.cx/) or [puma-dev](https://github.com/puma/puma-dev) to be able to run the app locally using a `.dev` domain. The GitHub OAuth callback is configured to accept requests from rubygamedev.dev.

## Writing Tests

Tests are an important part of making sure our website is running correctly. We appreciate when you include tests when you contribute new features or fix bugs, but don't let that stop you from getting involved. We've tried to make it easy for you to start writing tests. Start up Guard in order to run the test suite:

```bash
$ bundle exec guard
```

Press enter to run all of the tests, or save a file to run its corresponding test automatically.

We use RSpec for unit tests and Cucumber for integration tests.

## Submitting a Pull Request

From your forked repository, create a separate branch. Then submit your pull request. When your pull request has been accepted, it will automatically be deployed.

## Getting Help

If you ever need help, don't hesitate to ask. We don't have a mailing list, so feel free to submit a GitHub issue or join us in our [Gitter chat room](https://gitter.im/ruby-rcade/RubyGameDev.com?utm_source=badge&utm_medium=badge&utm_campaign=share-badge).