First and foremost, you must be aware that the Pharo project only accepts code published under the MIT license. By publishing your code in the SqueakSource Pharo or PharoInbox repositories, you are agreeing to this condition.

With that out of the way, here are the steps to submit your contributions:

• Prepare a changeset with your changes. File it out. Important: Put your Full name instead of your initials, it will help up to contact you as it is often necessary. Do not use space and only alphabetical characters.

• Load your changes into a fresh image:
• Download the latest Pharo image from http://code.google.com/p/pharo/wiki/Downloads?tm=2.
• Launch the fresh image and load the latest updates by clicking on the ''load code updates'' button on the left flap.
• Important: Save the image at this point, so that you don't need to reload the updates when you test your changes.
• File in your changeset.

• There is two alternatives :
1. Your modification affect only one package :
• Open the Monticello browser. You should see only one package marked as modified (with an asterisk before the package's name).
• Select your package-cache repository on the right hand pane.
• Save the package (click on the "Save" button). An mcz package will be saved in your cache. You will be prompted for a log message, type a useful comment.
2. Your modification affect more than one package : you have to create a SLICE package in your package cache
• Open the Monticello browser. You should see one or more packages marked as modified (they have an asterisk before their name).
• Select your package-cache repository on the right hand pane.
• Create the new package (click on the ''+Package'' button). Name it SLICE-nameofchange, (e.g. SLICE-remove-isMorphic).
• Make all the modified packages (the ones with asterisks before their names) required by your SLICE package. To do this, right click on the SLICE package in the left pane and select ''add required package'', then select the package from the next menu. Repeat for all modified packages.
• Save the SLICE package (click on the ''Save'' button). An mcz package will be saved in your cache for the SLICE package and all the modified packages. You will be prompted for a log message for each one of them, type a useful comment for the first package, copy it and paste it on the others. Make sure to give the number of the issue your SLICE addresses in the comment.

• To prepare for the next step, quit the image without saving.

• Test your package in the clean image:
• Relaunch the clean Pharo image. If you didn't save the image after loading the updates, load the updates (I told you it was important!).
• Open the Monticello browser.
• Open your package-cache repository (select the package-cache in the right pane, click on the ''Open'' button).
• Load your package. If it loads without errors, you are ready for the next step. If there are errors, try again, or ask for help in the mailing list.

• Publish the package to PharoInbox SqueakSource repository:
• In the Monticello browser add the PharoInbox repository: make sure the package is selected in the left pane, then click on the ''+Repository''. Select ''HTTP'' from the menu, then make sure that the location reads ''http://www.squeaksource.com/PharoInbox''.
• Finally, click on ''Save''.

• Track change:
• Add an entry to the Issues tracker describing your change (include the package version name of the package). Set the status to "Fixed".
• If your change is directly related to a Mantis report, add the label "Type-Mantis" and add the Mantis ticket number in front of the subject. Else choose another appropriate label
• Announce your contribution by sending a mail to the mailing list and herewith ask to have somebody review your change. This person should change the state of the issue to "Verified".
• Wait until your change was harvested (i.e., pushed into the update stream). The status will then be changed to "Closed".

Congratulations, the world is one step closer to being a better place!

We greately appreciate your effort.

In case of problems, you can send a changeset to the mailing list, but please only do this as a last resort.