How to contribute

Frontend Babel is an open source project publicly hosted on Github. You are very welcome to make a pull request, send a patch and create issues!

Here are some ideas on what could be your contribution:

Push new translation

If you are ready to push the new translation, then

  1. Set up the project locally
  2. Add an article text
  3. Make a pull request with your changes to an original repo

If you only want to suggest an article for future translation, create an issue.

Set up the project locally

  1. Fork the original repository
  2. Clone your repository and run:
    git clone  frontendbabel
    cd frontendbabel
    npm install
    docpad run
    You will need to have docpad installed on your computer. Follow their installation guide.
  3. Open (http://0.0.0.0:9778/) to see your project copy.

Working with articles' texts

Articles' sources are stored in the src/documents/articles/ directory. To add a new article create a new <article-name> folder, place index.html.md file and start.

The articles are written with Markdown. Explore an example to learn the structure.

Provide credits

You need to provide meta information about the original source, its author and translator, like the following:

source:
  name: Название статьи
  url: http://blog.author-site.name/article
  lang: RU

author:
  name: Ivan Ivanov
  site: http://blog.author-site.name/
  twitter: ivan
  github: awesomeivan

translator:
  name: Anna Smith
  site: http://anna.me/
  twitter: annaanna
  github: annasmith

Information about author's and translator's social network accounts is optional. However we recommend to provide it to recognize and promote people. It is nice if you contact the original author of the article and get his or her permission.

Provide meta information

It is recommended to provide meta information which makes an article more attrative when sharing link to it in social networks.

You might want to give an article short description. For this declare meta.desc property. Use > operator for long strings.

meta:
  desc: >
    Hugo Domingo, a freelance developer shares his experiments in SVG animation.
    Currently being supported by all the popular browseres this feature enables
    us to create stunning web effects.

Besides description, you can provide thumbnail and so make an article snippet more noticeable. To do this place a thumbnail into article source folder named as thumb.png (jpg and 'gif' are also possible extensions). You also can provide an URL to a third party resource with an image using meta.thumb property. However it is recommended to store thumbnails with articles.