Skip to content

Commit

Permalink
doc: add contributing rules
Browse files Browse the repository at this point in the history
  • Loading branch information
tonyghiani committed May 27, 2019
1 parent 8c525fc commit 05b8a42
Showing 1 changed file with 72 additions and 0 deletions.
72 changes: 72 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Contributing guideline

🚀First off, thanks for taking the time to contribute! 🚀

#### Table Of Contents

[What should I know before I get started?](#what-should-i-know-before-i-get-started)

[How Can I Contribute?](#how-can-i-contribute)
* [Reporting Bugs](#reporting-bugs)
* [Pull Requests](#pull-requests)

[Styleguides](#styleguides)
* [Git Commit Messages](#git-commit-messages)
* [JavaScript Styleguide](#javascript-styleguide)

## What should I know before I get started?

### Create Koa Application

Create Koa Application born as a CLI tool with the final purpose of integrating good practices for Node.js in a boilerplate, using a Koa.js app. The CLI generates a boilerplate and initialize a repository using the Koa template resource.

### Koa template

Koa template is the resource which host the code to run our application. It contains a working app which already implements good practices and that will continuously grow.

## How Can I Contribute?

### Reporting Bugs

This section guides you through submitting a bug report. Following these guidelines helps maintainers and the community understand your report :pencil:, reproduce the behavior :computer: :computer:, and find related reports :mag_right:.

Before creating bug reports, please be sure to check if a related issue already exist, the create one trying to be the most possible descriptive.

> **Note:** If you find a **Closed** issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.
#### How Do I Submit A (Good) Bug Report?

Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/). After you've determined [which repository](#atom-and-packages) your bug is related to, create an issue on that repository and provide information on how to reproduce the bug.

Explain the problem and include additional details to help maintainers reproduce the problem. 🤓

### Your First Code Contribution

In order to create your first contribution to this project, fork the repository on your GitHub account, clone it and create a new branch to fix a bug or implement a new feature.

We have not particular coding style, we just want to keep the code well organized and clean following good coding convention. If provided in form of script, run the formatting with prettier and follow the styling rules imposed by the linter.

Once you are done and you think your code works well, submit a Pull Request.

### Pull Requests

Please follow these steps to have your contribution considered by the maintainers:

1. Create a descriptive pull request and, if exist, reference the related issue.
2. Follow the convention of the existing code you are working on.

While the prerequisites above must be satisfied prior to having your pull request reviewed, the reviewer(s) may ask you to complete additional design work, tests, or other changes before your pull request can be ultimately accepted.

## Styleguides

### Git Commit Messages

* Use the present tense ("Add feature" not "Added feature")
* Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
* Limit the first line to 72 characters or less
* Reference issues and pull requests liberally after the first line
* When only changing documentation, include `[ci skip]` in the commit title

### JavaScript Styleguide

Right now, at this point of the development, there are not big restrictions on the code style, just remember to follow the styling rules imposed by the linter and use your coding skills! 🤓🚀 

0 comments on commit 05b8a42

Please sign in to comment.