[DOCS] Project "Magic Book"
hannes.hirzel.squeaklist at bluewin.ch
Wed Feb 19 10:11:51 UTC 2003
Nine days ago you wrote the interesting mail below
to the Squeaklist.
May I ask you what are your expections for the documentation
team to come up with?
We updated the page
There are various things which are beeing worked on now.
But we need "customers" like you. What are your interests in
doing with Squeak?
If you could post a message here or on the Swiki
that would be great. Learning to use the Swiki
is actually straightforward. Just look at what
others have done (of course there is as well a 'help'
We can't guarantee that we can come up with all you
want though (at least not instantly).
But it is necessary to know what people are looking for.
At the moment work in the documentation team is directed by
the personal priorities of the team members which is not a
bad thing either.
Thank you for participating
"Just4Fun" <Just4Fun000 at msn.com> wrote:
> >>doing documentation is somewhat
> considered to be a ''dummies'' job by many while at the same time in
> fact being a hard job.
> Personally, I've always thought the reason that support documentation
> for various programming languages was so poorly done was because many
> programmers tend to be talented in the 'left brain' activities while
> somewhat lacking in the 'right brain' areas. Aka. Those who are talented
> in math and science are not always talented in the verbal skills areas.
> Writing is a talent that should be respected too, and yes, it is every
> bit as hard to create technical or non-technical documentation as it is
> to create a programming product.
> I'm sorry that I don't know enough Squeak to help, but at this point,
> I'm following the discussions and working on my knowledge of other
> environments. I'm not talented in programming (read that math
> challenged); I enjoy the exercise of learning. I need effective
> documentation in order to learn a language. I am the programmer's worst
> nightmare. I am the person who reads the manuals!
> Thanks for trying to do something for the sake of people like me...
More information about the Squeak-dev