Contribute

Want to make this site better? Here’s what you’ll need to know:

Submitting a Tip

Want to submit a tip you’ve found useful? Great! There are two ways to do it. The ideal way:

  1. Fork the content repository on BitBucket.
  2. Add a new tip page (you can copy one of the existing ones as a template).
  3. Send a pull request.

The other way is to just email steve@stevelosh.com with your tip.

A few things to note:

Contributing to the Core Site

If you want to contribute to the structure and layout of the site itself, you can fork the site repository on BitBucket.

Translating the Site

If you want to help translate the site into a new language, here’s what you need to know.

First, find the ISO-639 language code for the language you’re translating into (for example: “ja” for Japanese or “fr” for French).

Now fork the content repository on BitBucket and clone it.

Each translation is on its own branch, which has the language code as its name. For example, the Japanese translation is on the “ja” branch.

Before you start you should check if someone has already started translating into this language. Run hg branches and look for a branch with the language code as its name.

If someone has already started, run hg update LANGUAGECODE to switch to the translation branch. If no one else has started, run hg branch LANGUAGECODE to get started.

Go ahead and translate a few tips. Commit as often as you like.

Once you’re ready for me to pull your changes, push to BitBucket and send me a pull request.

The main layout of the site will also need to be translated. Email steve@stevelosh.com to talk about that.

Licensing

The site and tips are licensed as Creative Commons Attribution-Share Alike. Any tips, improvements and translations you submit will fall under that license.