Ian Clark wrote:

That's at most 240 primitives, if monadic and dyadic forms are given their own
wiki pages. 
<>
That is: to give monadic and dyadic cases of *all* primitives their own 
separate pages.


Skip says:

I don't think it is a good idea to give the monadic and dyadic forms of 
primitives separate pages in the reference tutorial. When a novice sees 
a symbol in an expression, they will want to go to the page for that 
symbol. If there are two pages for that symbol, which page do you take 
the novice to, when they click on the symbol on the opening page?

Making the assumption that the novice knows all about monadic and dyadic 
when they first visit the reference tutorial is a bad assumption. Even 
intermediate-level J-ers aren't always able to guess the valence of a 
specific symbol in an expression without taking some time to analyze it. 
The revelation that a function can have single and dual-arguments, which 
can do very different things, is something that should be woven into 
each primitive function description. 

One of the key parts of the template for every primitive will be the 
part that makes sure that the novice understands the meaning of monadic 
and dyadic (and other key concepts) before proceeding, no matter what 
primitive they stumble upon first. That is the purpose of the 
exclamation-point and question-mark graphics I proposed previously.

Again, this reference tutorial should be focused on the novice, not the 
intermediate or expert-level J programmers, if we want to use it to 
broaden  the usage of J.

The only alternative that I can think of to the "!?" hyperlinked 
graphics in each primitive template would be to have a "beginners go 
here first" link on the J Softwate home page that links to a page 
explaining that symbols can have one or two characters, monadic and 
dyadic usage, and perhaps a couple of other concepts that are crirical 
for the beginner to understand. Even then, other concepts such as rank, 
and parts of speech would possibly be better revealed at points in the 
primitives' description text when the necessity arises. Bringing new 
concepts into a tutorial when they are needed is a tried and true 
educational method, as opposed to trying to explain all the new concepts 
before wading into some actual code.

.Skip Cave

----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm

Reply via email to