File: CONTRIBUTING.md

package info (click to toggle)
ruby-hitimes 1.3.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid, trixie
  • size: 352 kB
  • sloc: ruby: 1,196; ansic: 418; java: 265; makefile: 15
file content (57 lines) | stat: -rw-r--r-- 2,309 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Hi there!

I see you are interested in contributing. That is wonderful. I love
contributions.

I guarantee that there are bugs in this software. And I guarantee that there is
a feature you want that is not in here yet. As such, any and all bugs reports
are gratefully accepted, bugfixes even more so. Helping out with bugs is the
easiest way to contribute.


## The Quick Version

* Have a [GitHub Account][].
* Search the [GitHub Issues][] and see if your issue already present. If so
  add your comments, :thumbsup:, etc.
* Issue not there? Not a problem, open up a [new issue][].
    * **Bug reports** please be as detailed as possible. Include:
        * full ruby engine and version: `ruby -e 'puts RUBY_DESCRIPTION'`
        * operating system and version
        * version of hitimes `ruby -rubygems -e "require 'hitimes'; puts Hitimes::VERSION"`
        * as much detail about the bug as possible so I can replicated it. Feel free
          to link in a [gist][]
    * **New Feature**
        * What the new feature should do.
        * What benefit the new feature brings to the project.
* Fork the [repo][].
* Create a new branch for your issue: `git checkout -b issue/my-issue`
* Lovingly craft your contribution:
    * `rake develop` to get started
    * `rake test` to run tests
* Make sure that `rake test` passes. Its important, I said it twice.
* Add yourself to the contributors section below.
* Submit your [pull request][].

## Building Windows Binaries

This is done using https://github.com/rake-compiler/rake-compiler-dock

1. have VirtualBox installed
2. have Docker Machine installed (https://docs.docker.com/engine/installation/)
3. `gem install rake-compiler-dock`
4. `rake-compiler-dock` (this could take a while)
5. `bundle`
6. `rake cross native gem`

# Contributors

* Jeremy Hinegardner
* Wojciech Piekutowski

[GitHub Account]: https://github.com/signup/free "GitHub Signup"
[GitHub Issues]:  https://github.com/copiousfreetime/hitimes/issues "Hitimes Issues"
[new issue]:      https://github.com/copiousfreetime/hitimes/issues/new "New Hitimes Issue"
[gist]:           https://gist.github.com/ "New Gist"
[repo]:           https://github.com/copiousfreetime/hitimes "hitimes Repo"
[pull request]:   https://help.github.com/articles/using-pull-requests "Using Pull Requests"