Slight cleanup of documentation?

[Boriss Mejias]

Graham Percival wrote:
> On Sat, 12 Jan 2008 03:25:33 +1000
> RGC <graemec at mysoul.com.au> wrote:
> 
>> I'm new to Mozart and Oz, and as I was looking through the
>> documentation I noticed that there are a few rough edges that
>> I thought indicated that English was perhaps not the first
>> language of the authors.
>>
>> Any other hints/advice/encouragement?

It would be really great if you could help us to improve the 
documentation. You can get check out the trunk version from the svn by doing

svn checkout --username mozart \ 
https://gforge.info.ucl.ac.be/svn/mozart/trunk/mozart

the password is the same as the username. That account does not have 
write permissions, but you can submit your patches over here, and one of 
the developers will commit it for you.

About the sgm files, this is something we inherited from the original 
developers, and nobody has got the time to do something better that that.

> 
> I can't speak about the Oz docs, but I've been working on the
> docs for Strasheela (a project built on top of Oz).  Strasheela
> has an interactive tutorial which introduces simple Oz constructs;
> I found it much more understandable than the Oz tutorial.
> 
> I don't know if there's any interest in adopting the Oz-specific
> parts of the interactive Strasheela tutorial for Oz itself, but it
> might be helpful.  Unfortunately I can't work on this until Feb
> (I have a conference deadline on Jan 25), but I would be quite
> interested in helping with the Oz documentation then.

Actually, we have received many complains about the current tutorial for 
being too much "researcher oriented" instead of "developer oriented". If 
anybody is willing to create a new tutorial for developers, it will be 
very welcome. That could be an alternative to fix the current tutorial, 
and as Graham suggests, it could be inspired by the documentation found 
in Strasheela. We can use the Mozart wiki to start this project, but if 
the wiki format is not convenient, we could create a sub-project at the 
Collozeum, taking advantage of a svn repository.

Mozart wiki:
http://gforge.info.ucl.ac.be/plugins/wiki/index.php?id=17&type=g

Collozeum:
http://gforge.info.ucl.ac.be/projects/collozeum/

cheers,
Boriss

> 
> Cheers,
> - Graham
> _________________________________________________________________________________
> mozart-users mailing list                               mozart-users at mozart-oz.org
> http://www.mozart-oz.org/mailman/listinfo/mozart-users