[[PageOutline(1-2)]]

= Smalltalk Koans =

Smalltalk Koans will guide you as a Smalltalk novice from first steps in Smalltalk to your first small project. The path is simple: You get a task, you solve it and you learned something.
 
The Koans Sensei (jap.: teacher) will guide you and show you e.g. Strings, Blocks, Collections and many more. 

= How to Install =
{{{
#!div class="wiki_infotable" style="float:right;"
||'''Environment'''|| ||
|| [[Image(media/icons/custom:squeak_16.png, title="Recommended Squeak Version", nolink, right)]] || 4.2 and later ||
|| [[Image(media/icons/silk:application_home.png, title="Recommended Squeak VM Version", nolink, right)]] || 4.1.1 (win) ||
|| [[Image(media/icons/silk:cog.png, title="Recommended Cog VM Version", nolink, right)]] || r2499 ||
}}}

Using Metacello, just run the following code in your workspace:
{{{
(Installer mc http: 'http://www.squeaksource.org/')
  project: 'koans';
  install: 'ConfigurationOfSmalltalkKoans'.
ConfigurationOfSmalltalkKoans load.
}}}

If you later want to get the latest development version, run this:

{{{
ConfigurationOfDesigner loadDevelopment.
}}}

'''System categories'''

{{{Koans-Core}}} ... Core and UI Components bringing the Sensei to life.[[br]]
{{{Koans-Abouts}}} ... All Smalltalk koan lessons.[[br]]
{{{Koans-Bonsai}}} ... Additional classes used during lessons.[[br]]


'''Version 1.0'''

 * initial release

= How to Use =

After you installed the Koans you find them in the 'Apps' Menu.

After starting the Koans you will see a windows called Sensei. He will judge your progress and guide you to the next task. Three buttons 

= Acknowledgments =

The Smalltalk Koans were inspired by the Edgecase Ruby Koans project and the original "The little Lisper" Book by Daniel P. Friedman and Matthias Felleisen.

[[Image(media/icons/silk:user.png, title="Contributors", nolink)]] To date the following people contributed to this project: 
 * Eric Seckler
 * Robin Schreiber
 * Patrick Rein