[squeak-dev] Squeakapedia?! (reply to Ralph)

Jerome Peace peace_the_dreamer at yahoo.com
Wed Jun 16 22:31:28 UTC 2010


"Try something. If that doesn't work. Try something else."  
--The only way I know to program. -Jer


In response to my original post:
http://lists.squeakfoundation.org/pipermail/squeak-dev/2010-June/151287.html

>Ralph Johnson johnson at cs.uiuc.edu
Tue Jun 15 10:13:28 UTC 2010 wrote:

>So, what is wrong with the Squeak wiki?  Why isn't it used as much?

Ummm. That was NOT the question.

In the context of the original:

Problem:
Documentation of squeak and varients is a bear to find in an organized fashion.

The question I raised is who out there is willing to help solve this problem?

Answering as you have I am hurt. It was both out of context, off thread, and essentially of the tone:

Things are bad lets (implicitly) keep them that way.

In source documentation is a good idea. I've tried lots of it. When I fixed things with change sets I wrote extensive prologs which guided me and others as long as prologs were included in the source. MC broke that. Plus the prologs got jettisoned as bath water from time to time anyway.

MC allows comments. But you never see them all in one place at one time. Another loss of knowledge. You had a student who was working on making a database of previous version of methods. He finished his project and disappeared. The database for 3.9 or 3.10 never was created. You never followed up on that. So no database of versions exists. I miss that diagnostic tool because it was the only way to find out which fool introduced which bug.

Mediawiki's are everywhere. Swiki is in only one place. That tells several things. First off, many more people out there know how to edit a mediawiki. We could carry on this mailing list in Esperanto but we use English because we are familiar with it. Language is not a local phenomenon. Nor are flavor of wikis.

So I need to ask again. In the context of the original problem is there anyone out there willing to help with a solution that includes using a Mediawiki?

Yours in curiosity and service, --Jerome Peace






      



More information about the Squeak-dev mailing list