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:
- Fork the content repository on BitBucket.
- Add a new tip page (you can copy one of the existing ones as a template).
- Send a pull request.
The other way is to just email firstname.lastname@example.org with your tip.
A few things to note:
- Entries are written in Markdown.
- Entries must have an excerpt.
- Make sure you fill in your name and site so you get credit!
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 email@example.com to talk about that.
The site and tips are licensed as Creative Commons Attribution-Share Alike. Any tips, improvements and translations you submit will fall under that license.