Skip to content

Latest commit

 

History

History
72 lines (41 loc) · 3.51 KB

CONTRIBUTING.md

File metadata and controls

72 lines (41 loc) · 3.51 KB

Contributing guideline

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

Table Of Contents

What should I know before I get started?

How Can I Contribute?

Styleguides

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 📝, reproduce the behavior 💻 💻, and find related reports 🔎.

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. After you've determined which repository 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! 🤓🚀