This area is for discussion of major editing changes to existing content. For example, if you want to restructure how existing chapters are arranged, please discuss it here first.

If you want to add new pages to the tutorial on new topics, just go ahead and add them - you don't need to discuss that here unless the new topics are controversial or in some way unrelated to OCaml.


-- There is a Copyright page where one can read "This tutorial is copyright © by the original contributors", is copyright an opened topic or a closed topic ? Whatever copyright/license, i think the info should be visible on the main page, or is copyright a per-page or a per-author question ? BrickCaster

I don't want to get too hung up on the (C) issue. If you want to assert copyright explicitly on your portions, why not edit the Copyright page to say so? -- Richard W.M. Jones

I'm thinking about translation of this Wiki, and in my opinion it would be great if it is under some free license. I don't know much about this topic, but how about GFDL with contributer lists (include Merjis) as an invariant section? -- yoriyuki

Couple of things then

  1. There is an Italian translation which Luca (lucab83-at-infinito.it) has been slowly plugging away at. There's no direct page yet, but if you look at the sitemap and look for pages called it/... you can find the translations. So that's a good way to start the Japanese translation (pages called jp/...). がんばれ!
  2. On the topic of the license. I and Merjis fully support open content licenses, and if this wiki needs to be (re-)licensed under GFDL or a Creative Commons license [or public domain?], then we are all for that. It would be nice if there was some sort of discussion by some of the other contributors, and once everyone's decided/voted on what they want, let's go ahead and change the license.

-- Richard W.M. Jones

I think both the GFDL or a similar Creative Commons license are fine. They both allow aggregates, i.e. someone can take some material from the wiki and make it a chapter of a book where other chapters are distributed under other terms. I would avoid public domain because it more or less allows misappropriation. -- Martin Jambon

OK, I made ja page. I agree all my translation to be distributed with a free license (either GFDL or creative commons).

You might want to name the translated pages after the same pattern as the Italian pages, e.g. http://www.ocaml-tutorial.org/it/the_basics. It would make it easier to switch from one language to another (not that I understand Japanese or that I offer to translate the site to French...) -- Martin Jambon

Discussion areas?

The main page says `Most pages also have their own discussion area (called "page/discussion") where you can discuss major changes affecting that page'. Is that true? Which page has a discussion area?

-- No, but you can add them if you want. Richard W.M. Jones


-- Should i provide corrections? Then how visible or how hidden? BrickCaster

-- I would just create a separate page for each solution (no password required :-). You can also create intermediate hint pages instead of unveiling the complete solution directly.

-- After second thought i think i won't provide nor hints nor corrections. This would diminish the value of the exercices when using in a computer course by a french teacher. As you may know OCaml is used in many computer courses in France, and giving hints, help, corrections should be the teacher choice, not mine. BrickCaster

-- Is this wiki written for french teachers? I'm a student in Austria and I want to learn OCaml. This wiki is great, the exercises are great, but without solutions, they are somewhat useless for the learning process. BTW: a good teacher can come up with his own exercises ;)

-- You make good points, of course this wiki is not made only for teachers. You appreciate my exercices and i thank you for the compliment. If you want to learn OCaml then i want to support you. However i still postpone my decision. If you feel the exercices are useless because you miss the corrections then e-mail me at BrickCaster and i will send you full sources.

-- I thinks, it is a good idea to add some simple exercises into the chapters of the tutorial itself, so that the reader could learn actually using Ocaml. aengus


It would be nice to see a "hello world" app. As it is, the tutorial doesn't even mention printing until well into the tutorial.

This is frustrating for someone new to ocaml who wants to create a program to be run later.

This simple app would be a good place to treat all the topics necessary to going from a simple ocaml source file to a distributable executable.

-- This is definitely something which I think should go in The Basics section, don't you think? Richard W.M. Jones

Newbie FAQ section

I'd love to see newbie FAQ section where we can ask questions and answers will be accumlated.

I know there is a newbie ML in Yahoo. But I hate Yahoo and its Ads and interface. I hate more to register and give them lots of personal data.

Besides, it will become FAQ/cookbook type of resources. More newbies, more user base, better funding, more tools/codes.

If not, moving newbie ML from Yahoo to any mailman host would be appreciated.

Thank you for providing wiki and tutorials!

-- Good idea! I've added a page for it (Newbie FAQ) - let's see if it takes off. Richard W.M. Jones

-- Thank you Richard!

OCaml Warts

I was wondering if anyone would work with me on a list of "OCaml Warts", similar to the well-known Python Warts document. The point of course is not to criticize the language, but to point out (and put in historical context) various unusual "features" that often trip people up, as well as the idiomatic workarounds. A lot of these appear spread around in the tutorial already. I think having them centralized would be a useful resource for people getting deeper into the language, as well as perhaps to provide a kick in the pants to the developers or to those who might write camlp4 extensions to get around these things. A few things I can think of off the top of my head are: the ;; operator, separate arithmetic operators for floats, the concurrent thread issue, and the fun/function dichotomy. Anyway, I think this would be a nice document to have in the wiki -- would anyone else work on it? Mike Lin

I totally support your idea. I think it's great to offer different tutorials which are structured differently. Overlap with other tutorials is great: it gives the reader an idea of what is important. So please start such a page, and people might add some suggestions. Martin Jambon