Notice: Since Vasili has decided that he does not want anyone continuing off his work, development is on hold until he gets back to us with a copy of the guide pre-dating his taking over.
With Vasili retiring as caretaker of the guide, we will be moving forward as a community to update the guide in a collaborative fashion, instead of electing someone new to take over. Hopefully, cooperation by the community as a whole will result in a clean, well-checked, and unbiased guide. The guide development is currently being hosted in a repository at BitBucket
Development is simple, anybody is free to create an account at BitBucket and make edits to the guide, however they will not immediately go live. Instead, these edits will then be visible at
where the community will review them. If they are approved, they will be merged into the guide. The current state of the guide can be downloaded from
(single text file, will be periodically manually updated)
(zip file containing the parts, automatically fully up to date at all times)
(online viewing, also fully up to date at all times)
When adding a change, post a link to it in this thread. People will be able to view what was changed, discuss it, and use the forums “Agree/Disagree” function to vote yes or no. These votes can be changed later as the change is updated to reflect people’s comments. After a couple days, if a change has at least 1 Agree and no Disagrees, it will be added to the guide (reviewers should use some discretion, if the change is large or controversial, give it more time, if it is something simple like spelling corrections, push it through quickly). If anyone disagrees, that disagreement should be discussed fully before deciding whether to move forward with the change.
Instructions for adding a change follow:
- Make an account on bitbucket.org and log in.
- Go to the page for this repository
- Click the ‘Fork’ tab on top, then click “Fork repository” on the bottom
of the next page. This creates a copy on your account you can edit freely.
Every once in awhile, if somebody else makes changes to the guide, you
will see that your fork is behind in the upper right corner. Click "Sync now"
to get their changes into your copy. You will not be able to get your change
approved unless it is up to date with other people’s changes.
- Go the page for your own copy of the guide
- Click ‘Source’ on top
- Click any file(s) you wish to edit
- Click ‘Edit’ in the upper right corner
- Make your changes, then click ‘Commit’ in the lower right corner
- When your changes are ready click ‘Pull Request’ in the upper right corner
- Choose a meaningful title to tell people what you are changing
- Click ‘Create pull request’ on the bottom
Your changes are now up for review. If they are accepted, all files you changed
on your copy will be similarly changed on the main copy of the guide.
To expedite your review, please post a link to it here so we can look it over.