About documentation

[Kevin Glynn]

Thomas Packer writes:
 > Hello Moz people
 > 
 > 	Not that I expect anyone has enough free time to go out right now and edit 
 > documentation, but ... I kind of agree with most of the suggestions made 
 > below concerning documentation.
 > 

I agree too, and hopefully they will be taken into account as the
documentation is (slowly) maintained.

Non-concrete complaints about the documentation are appreciated, but
concrete proposals for improvements are much easier to act upon :-).

 > 	I will add one of my own:  There seem to be some undocumented features of the 
 > language of some importance -- or at least they were quite hard to find using 
 > the top-level index.  These features include such things as the simple way to 
 > assign and access cells using operators instead of functions.  Would a new 
 > user know that these operators are available by looking up cells?
 > 

In the case of the cell update operators they are used in the Oz
tutorial and documented in the 'Infix Notations' section of the Oz
Base Environment document.  How would you suggest improving this?

What other features do you think are un/poorly documented?

 > 	Is the mozart-oz.org web site down today, by the way?  I cannot access it.
 > 

Unfortunately, it was down over the weekend. It is back now.

cheers
k