Changes between Version 14 and Version 15 of squeak_faq_new

Timestamp:

03/25/2015 11:57:27 AM (9 years ago)

Author:

fabio.niephaus

Comment:

Merge and improve introduction

squeak_faq_new

@@ -5 +5 @@
 == Documentation ==
 
-=== Where do I find good introductory literature for !Squeak/Smalltalk? ===
+=== Where do I find good documentation and introductory literature for !Squeak/Smalltalk? ===
 
-The book [http://www.squeakbyexample.org/ Squeak by Example] is a good starting point. Especially, the book explains the most important tools, the morphic framework and important concepts, such as messages.
-
-In the [http://wiki.squeak.org/squeak/792#Morphic morphic wiki] you can find tutorials how to work with morphic and squeak.
-
-There are also many books available for free: An overview can be found here: [http://stephane.ducasse.free.fr/FreeBooks.html Stephane Ducasse: Free Books]
-
-We also created some [https://www.hpi.uni-potsdam.de/hirschfeld/trac/SqueakCommunityProjects/wiki/squeak_screencasts screencasts] explaining how to work with squeak.
-
-=== Where do I find a good documentation? ===
-
-For most of the classes you can view the documentation directly in the browser. The "?" Button between class and instance shows class comments.
+In most cases, you do not necessarily need a documentation, because you can search and browse through the entire source code within your Squeak image. Just use the search on the top right to find what you are looking for. The majority of classes also come with class comments that you might find helpful. You can access these by clicking the `?` button between `instance` and `class` in your browser.
 
 Furthermore, we recommend the following websites: 
 
-* [http://squeakbyexample.org/ Squeak by Example]
+* [http://squeakbyexample.org/ Squeak by Example] (for more free books visit [http://stephane.ducasse.free.fr/FreeBooks.html Stephane Ducasse: Free Books])
 
-* [http://static.squeak.org/tutorials/morphic-tutorial-1.html Morphic Tutorial]
+* [http://wiki.squeak.org/squeak/5699 Terse guide to Squeak]
 
-* [http://wiki.squeak.org/squeak/30 Squeak-Wiki]
+* [http://wiki.squeak.org/squeak Squeak Swiki]
 
 * [https://www.hpi.uni-potsdam.de/hirschfeld/trac/SqueakCommunityProjects/wiki/squeak_screencasts Squeak Screencasts]
 
-* [http://wiki.squeak.org/squeak/5699 Terse guide to Squeak]
+* [http://wiki.squeak.org/squeak/792#Morphic Morphic Tutorials]
+
+* [http://static.squeak.org/tutorials/morphic-tutorial-1.html Tutorial: Fun with the Morphic Graphics System]
 
 == Smalltalk Syntax ==