gitmoji/.github/CONTRIBUTING.md
2016-11-14 21:49:32 +01:00

2.0 KiB

Contributing to gitmoji

Hello!

Thanks for for contributing on gitmoji. Before implementing new features and changes, feel free to submit an issue. We're going to talk here 😜.

If you would like to add a new emoji to gitmoji, fill the provided ISSUE_TEMPLATE when creating an issue and take a look at the contributing section.

How to submit a pull request?

  1. Fork this repository.
  2. Create a new branch with the feature name. (Eg: add-emoji-deploy, fix-website-header)
  3. Make your changes.
  4. Commit your changes. Don't forget to add a commit title with an emoji and a description.
  5. Push your changes.
  6. Submit your pull request.

How to add a gitmoji

  1. Open the gitmoji.json file located at src/data/gitmojis.json.
  2. Add your emoji using the following code inside of the gitmojis array []:
  3. Save the file and create a pull request.
{
	"emoji": "",
	"code": ":code:",
	"description": "Enter the description for the gitmoji.",
	"name": "code (same as code but without ':' replace underscores for dashes _ => - )"
}

How to start gitmoji and update

If you want to make changes to the site, follow the next steps:

  1. Clone gitmoji
$ git clone https://github.com/carloscuesta/gitmoji.git
$ cd gitmoji
  1. Install the dependencies and start the development task.
$ npm i && gulp
  1. Make sure the styles are using a link instead of being inlined.

If you are updating the SCSS files and the styles doesn't get updated, go to the index.pug and about.pug paste the following code

link(href="css/style.css", type="text/css", rel="stylesheet")

Remove this one

style
	include ../../dist/css/style.css

After making your changes, inline the styles as before.

The project is built with Pug and SCSS