Skip to content

Latest commit

 

History

History
63 lines (46 loc) · 1.94 KB

CONTRIBUTING.md

File metadata and controls

63 lines (46 loc) · 1.94 KB

Contributing Guide

Contributing to ts-react-playground is fairly easy. This document shows you how to get the project, run all provided tests and generate a production-ready build.

It also covers provided tasks that help you develop with ts-react-playground.

Dependencies

To make sure that the following instructions work, please install the following dependencies on you machine:

  • Node.js (comes with a bundles npm)
  • Git

Installation

To get the source of ts-react-playground, clone the git repository via:

$ git clone https://github.com/gregoranders/ts-react-playground.git

This will clone the complete source to your local machine. Navigate to the project folder and install all needed dependencies via npm:

$ npm install

This commands installs everything which is required for building and testing the project.

Testing

npm test executes the unit tests.

Building

npm build executes the build.

Contributing/Submitting changes

  • Check out a new branch based on development and name it to what you intend to do:
    • Example: 
      $ git checkout -b BRANCH_NAME origin/development
      If you get an error, you may need to fetch development first by using 
      $ git remote update && git fetch
    • Use one branch per fix/feature
  • Make your changes
    • Make sure to provide a spec for unit tests.
    • Run your tests with npm test.
    • When all tests pass, everything's fine.
  • Commit your changes
    • Please provide a git message that explains what you've done.
    • ts-react-playground uses generate-changelog, so please make sure your commits follow the conventions
    • Commit to the forked repository.
  • Make a pull request
    • Make sure you send the PR to the development branch.
    • CI is watching you!