About documentation

[Thomas Packer]

Hello k

	Yes, it's always harder to provide constructive solutions rather than random 
criticisms.  But here's an attempt.

	I did see the "Infix Notations" section once or twice before I realised it 
applied to my question of how to easily operate on cells.  I think the reason 
I didn't go there originally was the title.  I suppose the easiest way to 
help us ignorant folks make use of the infix page when looking for 
documentation on a particular construct that uses infix notation is to 
provide a link from, e.g., the cells page, back to the infix page, saying 
that there are some operators that apply to cells that are not listed here.  

	It's hard to say anymore without sounding unreasonabily nit-picky.  And I 
haven't used the documentation in a while, so it's not fresh on my mind.  
I'll keep my eyes open in the future.

	Danke, danke
tomp


On Monday 30 August 2004 03:27, Kevin Glynn wrote:
> 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

-- 

Ciao,
TomP in BYU CS NLP

I have changed my email address to:
tpackers at byu.net

Check out my way of indexing information:
http://www.ontolog.com/LinkRanker
````````````````````````````````````````````````````````````