1
0
mirror of https://github.com/nostalgic-css/NES.css.git synced 2025-01-17 05:38:15 +01:00
nes.css/CONTRIBUTING.md
Trezy 9352ea9ced docs: Update README and add CONTRIBUTING
I've moved all of the development information from `README.md` to `CONTRIBUTING.md`, plus added some
information that I included in a lot of my other contributing instructions.
2018-12-11 00:04:56 -06:00

4.1 KiB

Contributing

You want to contribute to the project? Awesome!

Things to know

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please see our Code of Conduct for details on reporting unacceptable behavior.

Working on your first Pull Request? How to Contribute to an Open Source Project on GitHub

How do

Project setup

We're really happy you want to contribute to the project! ❤️ The following steps will get you up and running:

  1. Fork and clone the repo
  2. Install the required dependencies:
    $ npm install
    
  3. Start up the dev server:
    $ npm run storybook
    

Directories

.
├── index.html: Demo page
├── style.css: Demo page style
├── css: Distribution files
├── docs: Storybook stories
└── scss: Source
    ├── base
    │   ├── reboot.scss: Don't change! (Bootstrap Reboot)
    │   ├── generic.scss: Generic style and reboot.css
    │   └── variables.scss: Common variables
    ├── elements
    ├── form
    ├── icons: 16x16 icons
    ├── pixel-arts: For icons other than 16x16.
    └── utilities

Tip: Keep your master branch pointing at the original repository and make pull requests from branches on your fork. To do this, run:

git remote add upstream https://github.com/nostalgic-css/NES.css.git
git fetch upstream
git branch --set-upstream-to=upstream/master master

This will add the original repository as a "remote" called "upstream," Then fetch the git information from that remote, then set your local master branch to use the upstream master branch whenever you run git pull. Then you can make all of your pull request branches based on this master branch. Whenever you want to update your version of master, do a regular git pull.

Contributing for members of the nostalgic-css organization

Below are steps which must be followed by the members of the nostalgic-css organization. External collaborators only have to follow the above guidelines.

Steps for development

  1. Branch from develop using the formatting rules below.
  2. Do the work required to satisfy the issue. If you identify work that is unrelated to the issue, please create a new issue and do the work on a separate branch.
  3. Submit your PRs to merge back into develop.
    • Any change which would affect current development should be documented in the description.
    • PRs with an issue should be include that issue's number in the title. IE: [#33] Fix bug
    • Assign the PR to yourself.
    • When the PR is ready to be merged, A review should be requested from the nostalgic-css/NES.css team.
  4. Once the PR is approved, it is the responsibility of the assignee to merge the changes to the branch.

Commit formatting

We use Commitizen and commitlint to make sure all of the commits to the project are easy to read, and semantic-release to ensure that our releases are automated, unromantic, and unsentimental.