Graham Percival wrote:
On Sat, 12 Jan 2008 03:25:33 +1000
RGC <[EMAIL PROTECTED]> 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                               
[email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users
_________________________________________________________________________________
mozart-users mailing list                               
[email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users

Reply via email to