hey this is really neat! I can offer you some corrections or perhaps suggestions for better phrasing. just my native 2p if it helps. As a general comment, i know it would be more work, if you could get some emphasis e.g bold, italics it would really make the expressions and names of classes or methods stand out. ---Welcome--- I suppose you have called me to learn Smalltalk. --> You must want me to help you learn Smalltalk! ---Doing vs printing--- You've just executed a Smalltalk instruction --> You've just executed a Smalltalk expression ---Doing vs printing 2--- It's a Do It which print the result --> It's a Do It which prints the result ---basic types numbers--- you know how to execute Smalltalk code --> you now know how to execute Smalltalk code ---basic types characters--- A Character can be instanciated --> A Character can be instantiated --basic types string--- Use single quotes to create a String instance --> Use single quotes to create a String. ---basic types dynamic array--- Dynamic Array are created at execution time: --> Dynamic Arrays are created at execution time: ---unary messages--- Unary messages have the following form: anObject aMethod name --> anObject aMethodName --keyword messages-- The message is between:and: sent to Number object --> The message is between:and: sent to the Number 4 ---message syntax: execution order--- Between similar messages, expressions are executed from left to right --> Between messages of similar precedence, expressions are executed from left to right ---parentheses--- Use parentheses to change order --> Use parentheses to change order of evaluation ---mathematical precedence--- A message does not know mathematical precedence. Simplicity has a price :) --> (rephrase ?) Traditional precedence rules from mathematics do not follow in Smalltalk. The simplicity has a price ;) It might surprise you that precedence rules you know from mathematics do not apply here. This has a price as you can see... ---conditionals--- Conditionals are just message sent to Boolean objects --> Conditionals are just messages sent to Boolean objects ---loops--- Loops are messages send to collections, high-level iterators --> Loops are messages sent to collections, high-level iterators ---iterators--- Here we want to print all the numbers of the Transcript (a console) --> Here we want to print all the numbers on the Transcript (a console) ---() vs []--- --> I know what you are trying to articulate here, but this page doesn't really work since your 'annotation' is not syntactic and therefore your learning style breaks. pehaps have a think about this slide cheers Mike