Could the class documentation you are looking for be generated
automagically from the class comments? The first para could be a blurb
describing the purpose of the class. The resulting document could be
searchable.
--Trygve
On 26.03.2020 14:43, horrido wrote:
I didn't ask them that, but I
I didn't ask them that, but I did provide the link to PBE. It was up to them
to learn any way they wish.
You can't mandate people to read PBE. You can lead a horse to water but you
can't make it drink.
PBE is not a good resource if you want to look up classes that you need for
your application.
I am a little confused here. I originally learned Smalltalk from the
coloured books and
then Inside Smalltalk. When I got the chance to use Squeak, pretty
much everything
from those books carried over well enough for me to hit the ground
running. There are
lots of free e-books about Smalltalk,
On Wed, Mar 25, 2020, 08:49 horrido wrote:
> This is what I provided the JRMPC participants: https://jrmpc.ca/ (see
> "How
> to learn Smalltalk programming"). I'm not sure how I could've done better,
> though.
>
> You make an excellent point about duplication and keeping documentation
>
On Mon, Mar 23, 2020 at 7:29 PM Richard Kenneth Eng
wrote:
>
> https://jrmpc.ca/2020/03/20/what-makes-learning-smalltalk-challenging/
>
> FWIW, 95% of respondents pointed to the lack of reference documentation for
> the class library as the major obstacle to learning Smalltalk/Pharo.
>
Hi!
If
Exactly! The JRMPC participants were more used to looking things up quickly
and easily, rather than exploring. It's not easy to teach people how to
explore a system for needed information, and more importantly, it's a
time-consuming process. People are impatient.
Smalltalk is not for impatient
This is what I provided the JRMPC participants: https://jrmpc.ca/ (see "How
to learn Smalltalk programming"). I'm not sure how I could've done better,
though.
You make an excellent point about duplication and keeping documentation
up-to-date. However, there has to be some middle ground that makes
Or we teach people to fish…? What’s the point of duplicating everything that’s
already in the image anyway - we just need to be cleverer or ensure that people
know to look there and have the right onboarding experience to do that?
Otherwise its just another thing that gets out of date very
Pharo has some good documentation, but its more lesson-based than a library
reference.
Those of us familiar with Pharo know the tricks to use the system itself as
that reference, but I'd imagine this is an unfamiliar workflow for
newcomers.
I have seen before a class library reference generated
https://jrmpc.ca/2020/03/20/what-makes-learning-smalltalk-challenging/
FWIW, 95% of respondents pointed to the lack of reference documentation for
the class library as the major obstacle to learning Smalltalk/Pharo.
Richard
10 matches
Mail list logo
