Excerpts from Sven Van Caekenberghe's message of 2016-01-10 16:21:10 +0100:
> I have written many serious libraries with lot's of documentation and I have
> supported them for years, I have written standalone articles for various
> audiences and I am active on the ML's; I did my part for your points a) to e)
> Should I stop if even you cannot see it ? 

maybe this is the part of the problem, there is a lot of stuff, but it is not
always easy to find.

the graphic last month with a list of interesting tools and libraries for
various aspects of pharo was very informative. more of that would be nice.

same goes for documentation, a lot of it exists, but it could maybe be 
structured better.

what i mean here is, to group documentation by topic:

what do you want to do?

gui programming:
  from introduction to morphic/bloc/etc to serious complex gui applications
web development:
  seaside tutorial
  zinc tutorial (that is an excellent beginner tutorial btw)
  rest, etc...
data visualization:
  introduction to roassal, from simple example to advanced. most if not all of
    that is in the agile visualization book.
etc...

> You helped with PBE and did screencasts, which is b) - is that a 'complete'
> lack of beginner documentation ? 

since last year i have observed several students from middle-school to
university level, who all managed to learn pharo with little help, just by
pointing them to a series of tutorials.

the only extra motivation i have given them is a small task to solve on top of
each tutorial. very rarely i had to answer extra questions. for the most part
the students were able to work on their own with only the existing
documentation available to them.

while this is only anecdotal evidence, it shows that pharo is approachable by
beginners. and i would claim, even complete beginners who have never programmed
before, however i don't know if any of my students actually were complete
beginners.

> Yes, Pharo (Smalltalk) is a bit strange, needs some getting used to, but
> basically it is like most other OO languages (but better ;-).

and i would say it is only strange to those who are already somewhat
experienced and have only seen and used curly-brace languages.

> I disagree, I once let one of my sons take some Python lessons on the
> Raspberry PI. We had quite a few WTF moments, not the least when things did
> not go as advertised (in other words, error messages and debugging is ugly as
> hell). But more importantly the course (one of the 'best') started explaining
> weird syntax from the beginning, that is not beginner friendly at all. The
> underlying model is not nice, you cannot hide that for long.

what i like about python syntax for beginners is the indenting. it teaches
clean code formatting. the rest is no better or worse than other similar
languages.

greetings, martin.

-- 
eKita                   -   the online platform for your entire academic life
-- 
chief engineer                                                       eKita.co
pike programmer      pike.lysator.liu.se    caudium.net     societyserver.org
secretary                                                      beijinglug.org
mentor                                                           fossasia.org
foresight developer  foresightlinux.org                            realss.com
unix sysadmin
Martin Bähr          working in china        http://societyserver.org/mbaehr/

Reply via email to