Skip to content

Latest commit

 

History

History
78 lines (62 loc) · 2.95 KB

CONTRIBUTING.md

File metadata and controls

78 lines (62 loc) · 2.95 KB
Raw

Thanks for contributing!

👍 First of all, thanks for contributing! The team is happy to help if you have any questions. 🐾 The following is a set of guidelines for contributing to the server-side-renderer repository, which is hosted by the KNP Labs Organization on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document opening a pull request. :shipit:

Code of Conduct

This project and everyone participating in it is governed by the following Code of Conduct. By participating, you are expected to uphold this code.

Reporting a bug

Before submitting a bug

  • Verify that you are using the latest server-side-renderer version;
  • Double-check the documentation to see if you're not misusing the library;
  • Check if the issue has already been reported. If it has, and the issue is still open, add a comment to the existing issue instead of opening a new one.

How to submit a (good) bug report

To report a server-side-renderer bug please open a GitHub issue following the rules below.

  • Use a clear and descriptive title for the issue to identify the problem;
  • Describe the steps needed to reproduce the bug including a code example when possible;
  • Give as much detail as possible about your environment (version, configuration, context, ...);

Suggesting enhancements

To suggest enhancements please open a GitHub issue following the rules below.

  • Use a clear and descriptive title for the issue to identify the problem;
  • Provide a step-by-step description of the suggested enhancement in as many details as possible;
  • Explain why this enhancement would be useful with one or more use cases;

Contributing to the code

A pull request, is the best way to provide a bug fix or to propose enhancements to this repository.

When submitting a pull request please be sure to follow the same rules described above in Reporting a bug and Suggesting enhancements sections depending on the nature of your change.

Before starting to work on a large change please open an issue to ask the maintainers if they are fine with it (no one likes to work for nothing!).

  1. Fork the repository
  2. Once the repository has been forked clone it locally
git clone git@github.com:USERNAME/server-side-renderer.git
  1. Create a new branch
git checkout -b BRANCH_NAME master
  1. Code!!!
  2. Add/Update tests (if needed)
  3. Update documentation (if needed)
  4. Run the tests and make sure that they are passing
make test
  1. Fix code style issues
make fix-js
  1. Squash your commits
  2. Rebase your branch on master and fix merge conflicts
  3. Open the pull request