Help (and where to find it) ?
Locked
 
|
Hi folks,
Where is help ? After years of Linux use and work, I've developed an habit of always looking at the same place for help files, even for newly-installed packages. Be it the man page, be it the info page, be it the doc/ subdirectory of the source package. Now, how does this go with Squeak ? Case in point: Connectors. I've installed Connectors. Three new tabs were created. I browse the new classes looking for high-level 'howto' information on how I can use this package to make, for instance, UML diagrams. Nope. There's a ConnectorsDemo demo but it fails when I paste and execute the code in a Workspace (following what I recently read in the well-made Lalonde book 'Discovering Smalltalk'). So where do I look for an howto to use this package ? Is there a generalized approach to where to find such info in Squeak ? Cheers, Al _______________________________________________ Beginners mailing list [hidden email] http://lists.squeakfoundation.org/mailman/listinfo/beginners |
Re: Help (and where to find it) ?
|
|
lanas wrote:
> Hi folks, > > Where is help ? > > After years of Linux use and work, I've developed an habit of always > looking at the same place for help files, even for newly-installed > packages. Be it the man page, be it the info page, be it the doc/ > subdirectory of the source package. > > Now, how does this go with Squeak ? > ... > Is there a > generalized approach to where to find such info in Squeak ? > > Cheers, > Al Good point, Al. I don't doubt that there are some excellent step-by-step "How to program in Squeak" tutorials out there... somewhere. But they are not readily accessible, at least not by me. I can't find a useful list of such tutorials, even, so I really haven't been able to get a good start. I program in Perl, JavaScript, several BASICs, Pascal, even (10 or 12 years ago) Smalltalk. But Squeak is impenetrable for the beginner. Most helpful would be a steering guide -- "Start with this tutorial, then do this one, and then this..." -- with a brief abstract of the instructional objectives for each segment. ---- Jerry Muelver _______________________________________________ Beginners mailing list [hidden email] http://lists.squeakfoundation.org/mailman/listinfo/beginners |
Re: Help (and where to find it) ?
|
|
Jerry Muelver wrote:
> lanas wrote: >> Hi folks, >> >> Where is help ? >> >> After years of Linux use and work, I've developed an habit of always >> looking at the same place for help files, even for newly-installed >> packages. Be it the man page, be it the info page, be it the doc/ >> subdirectory of the source package. >> >> Now, how does this go with Squeak ? >> ... >> Is there a >> generalized approach to where to find such info in Squeak ? >> >> Cheers, >> Al > > Good point, Al. I don't doubt that there are some excellent > step-by-step "How to program in Squeak" tutorials out there... > somewhere. But they are not readily accessible, at least not by me. I > can't find a useful list of such tutorials, even, so I really haven't > been able to get a good start. I program in Perl, JavaScript, several > BASICs, Pascal, even (10 or 12 years ago) Smalltalk. But Squeak is > impenetrable for the beginner. > > Most helpful would be a steering guide -- "Start with this tutorial, > then do this one, and then this..." -- with a brief abstract of the > instructional objectives for each segment. out there to help. In addition, the Squeak documentation team is putting together tutorials and assembling docs and helpful hints that are spread around the ether. Here are some links to get you started. These, in turn, will provide additional links for your reference: http://minnow.cc.gatech.edu/squeak/2983 http://minnow.cc.gatech.edu/squeak/377 http://www.iam.unibe.ch/~ducasse/FreeBooks.html http://minnow.cc.gatech.edu/squeak/5871 http://astares.smallscript.org/DIGITALIS/englisch/sqk/sqk00002.htm _______________________________________________ Beginners mailing list [hidden email] http://lists.squeakfoundation.org/mailman/listinfo/beginners |
Re: Help (and where to find it) ?
|
|
Hello all,
besides that there should be some references to documentation within the package you download or on the website where you download from, the squeakcomunity is always helpful. That seems (to me) the general approach :) Ned Konz had written some documentation about his package (Thank You). It's a Project on BobsSuperSwiki about 500kb. You can get it for example with a Squeak3.6 image, open a filelist, in the filter-pane (the one with '*' in it) type Connect*, in the left pane scroll down to Bobs SuperSwiki and klick on it (you need a Internetconnection), the right pane will be populated with the filtered projects, chose ConnectorsMS-nk.013.pr and load it in. You will get this project and within it you have an interactive documentation called Welcome To Connectors! Or if you have a fast Internetconnection you can download (46mb) http://www.iam.unibe.ch/~ducasse/Web/Demoes/ <http://www.iam.unibe.ch/%7Educasse/Web/Demoes/April02Demo.zip>A <http://www.iam.unibe.ch/%7Educasse/Web/Demoes/April02Demo.zip>pril02Demo.zip <http://www.iam.unibe.ch/%7Educasse/Web/Demoes/April02Demo.zip> it's an image with a presentation of many many squeak-projects (many are just slides, but Welcome To Connectors! is a real project so you can interact with it). Enter the project Demo Space, in the upper right corner enter Connectors Demo. If you find newer or better documentation, or if you create some yourself, then it might be a good idea to put it on the swiki. Cheers Rudolf Brad Fuller schrieb: > Jerry Muelver wrote: > >> lanas wrote: >> >>> Hi folks, >>> >>> Where is help ? >>> >>> After years of Linux use and work, I've developed an habit of always >>> looking at the same place for help files, even for newly-installed >>> packages. Be it the man page, be it the info page, be it the doc/ >>> subdirectory of the source package. >>> >>> Now, how does this go with Squeak ? >>> ... >>> Is there a >>> generalized approach to where to find such info in Squeak ? >>> >>> Cheers, >>> Al >>> >> Good point, Al. I don't doubt that there are some excellent >> step-by-step "How to program in Squeak" tutorials out there... >> somewhere. But they are not readily accessible, at least not by me. I >> can't find a useful list of such tutorials, even, so I really haven't >> been able to get a good start. I program in Perl, JavaScript, several >> BASICs, Pascal, even (10 or 12 years ago) Smalltalk. But Squeak is >> impenetrable for the beginner. >> >> Most helpful would be a steering guide -- "Start with this tutorial, >> then do this one, and then this..." -- with a brief abstract of the >> instructional objectives for each segment. >> > Documentation could always be better, but there are quite a lot of info > out there to help. In addition, the Squeak documentation team is putting > together tutorials and assembling docs and helpful hints that are spread > around the ether. > Here are some links to get you started. These, in turn, will provide > additional links for your reference: > > http://minnow.cc.gatech.edu/squeak/2983 > http://minnow.cc.gatech.edu/squeak/377 > http://www.iam.unibe.ch/~ducasse/FreeBooks.html > http://minnow.cc.gatech.edu/squeak/5871 > http://astares.smallscript.org/DIGITALIS/englisch/sqk/sqk00002.htm > _______________________________________________ > Beginners mailing list > [hidden email] > http://lists.squeakfoundation.org/mailman/listinfo/beginners > > > _______________________________________________ Beginners mailing list [hidden email] http://lists.squeakfoundation.org/mailman/listinfo/beginners |
Re: Help (and where to find it) ?
|
|
In reply to this post by Brad Fuller
The Welcome To Connectors! project by Ned Konz is now on the swiki.
http://minnow.cc.gatech.edu/squeak/uploads/1773/ConnectorsMS-nk.pr Cheers Rudolf _______________________________________________ Beginners mailing list [hidden email] http://lists.squeakfoundation.org/mailman/listinfo/beginners |
«
Return to Squeak - Beginners
|
1 view|%1 views
| Free forum by Nabble | Edit this page |