How to contribute

JSRocks.org is a collaborative website about the latest JavaScript features and tools.
Anyone can contribute by writing an article, making a layout change, suggesting new sections, reporting issues, etc.
Contributing to JS Rocks is super easy, choose the type of contribution you want.

Writing an article

The JS Rocks website is built with Harmonic, our static site generator.

• First thing you need to do is to install Harmonic.

npm install harmonic -g

You'll need Node.js >= 0.10 (or io.js) and npm already installed.
Check out the main Harmonic documentation if you're in trouble.

• Fork and clone the jsrockshq.github.io repository

# replace YOUR_USERNAME with your GitHub username below
git clone https://github.com/YOUR_USERNAME/jsrockshq.github.io.git
cd jsrockshq.github.io
git remote add upstream https://github.com/JSRocksHQ/jsrockshq.github.io.git

• Create a new branch using upstream/src as base and checkout to it

git fetch upstream
git checkout -b my-awesome-post upstream/src

• Create a new post

harmonic new_post "My awesome post"

This command will create a new markdown file in /src/posts/[LANG].

• Run Harmonic to check if your post is ready

harmonic run

This command will build and run the JS Rocks website in the default port 9356.

• Commit your changes

git add .
git commit -m "my awesome article"

• Push your new branch to your forked repository

git push origin HEAD

Go to your forked repository's page on Github.com and create a pull request for the src branch.

Issues

You can help JS Rocks by finding a bug in the website, a typo in an article or even an incorrect sentence.
File an issue, and we will solve it ASAP.