Sha256: 2e6e3f9ccdc88ed1250446217f777d7917fa434ca50d86f64c5e5723300d6abd

Contents?: true

Size: 1.68 KB

Versions: 5

Compression:

Stored size: 1.68 KB

Contents

# Contributing to Fusuma

1. Fork the repo, develop and test your code changes.
2. Send a pull request.

## Setup

In order to use the Fusuma console and run the project's tests,
there is a small amount of setup:

1. Install Ruby. Fusuma requires Ruby 2.3+. You may choose to
   manage your Ruby and gem installations with [RVM](https://rvm.io/),
   [rbenv](https://github.com/rbenv/rbenv), or
   [chruby](https://github.com/postmodern/chruby).

2. Install [Bundler](http://bundler.io/).

   ```sh
   $ gem install bundler
   ```

3. Install the top-level project dependencies.

   ```sh
   $ bundle install
   ```

## Fusuma Tests

Tests are very important part of Fusuma. All contributions
should include tests that ensure the contributed code behaves as expected.

To run tests:

``` sh
$ bundle exec rspec
```

### Fusuma Document

The project uses [YARD](https://github.com/lsegal/yard) for generating documentation.  

If you're not sure about YARD, please refer to [YARD cheatsheet](https://gist.github.com/phansch/db18a595d2f5f1ef16646af72fe1fb0e).

To run the Fusuma documentation tests:

``` sh
$ bundle exec yard --fail-on-warning
```

To check Fusuma documents with running local server:

```
$ bundle exec yard server
```
Then open (http://localhost:8808/)

## Coding Style

Please follow the established coding style in the library.
The style is is largely based on [The Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide).

You can check your code against these rules by running Rubocop like so:

```sh
$ bundle exec rubocop
```

## Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By
participating in this project you agree to abide by its terms.

Version data entries

5 entries across 5 versions & 1 rubygems

Version Path
fusuma-2.0.0 CONTRIBUTING.md
fusuma-2.0.0.pre2 CONTRIBUTING.md
fusuma-2.0.0.pre CONTRIBUTING.md
fusuma-1.11.1 CONTRIBUTING.md
fusuma-1.10.2 CONTRIBUTING.md