How to contribute to Squeak
Last updated at 2:56 pm UTC on 12 September 2017
Squeak is maintained by many people using a community process, in which anyone at any level can participate in some way.
Contributing your package
SqueakMap If you write a cool package, this is where you should place it. This catalog allows anyone to install your code easily from Squeak.
- Reporting Bugs and Fixes explains what to do if you find or fix a problem, or want to improve functionality in the image.
- Commenting Bugs and Fixes is where you can help even if you're completely new to Squeak. For example, if you had a problem, asked on the mailing list, and someone more experienced fixed it, you could help out by commenting bugs and fixes.
Contributing to the Base System
The general development process of Squeak is described in https://squeakboard.wordpress.com/2009/07/02/a-new-community-development-model/.
If you want to contribute an improvement you can submit it to the "Inbox" repository which you can add as described in Inbox. Developers on the squeak-dev mailing list will be notified and the change might be discussed there.
Handling Commits from the Inbox
If a change in the inbox is accepted the following should be done by a core developer to merge it:
- Merge the commit in an up-to-date trunk image
- Make sure the commit works with the up-to-date image
- Commit the merged state
- The merge commit has now two ancestors: the previous head of the trunk repository and the commit from the inbox. To provide a consistent history, we have to move the inbox commit to the trunk repository. Therefore go to http://source.squeak.org/inbox and look for the commit under versions. After clicking on the version you see details of the version and two buttons which allow you to move the version either to trunk or the treated inbox. Use the move to trunk button to move the change to the trunk.
In case there are no new commits in the trunk repository, core developers can also simply use the "Move to Trunk" button on http://source.squeak.org/inbox.
- Harvesting Process If you want to get the big picture on how people's contributions turn into a stream of Squeak releases. (No longer used, historical)
- Mantis Server The bug/fix tracking tool for Squeak (toor arely used, has a backlog of problems that need attention and pruning; get to it!)