search

ocsigen / tutorial-deprecated

Deprecated. Please use repository tuto instead.
http://ocsigen.org/tuto/manual/
10 stars 17 forks source link

Wiki examples become outdated very often #20

Open Kakadu opened 9 years ago

Kakadu commented 9 years ago

Right decision seems to enter text in .eliom file and use a tool which generates HTML from it. As a result we should get something like software foundations. Using that tool will solve the problem of non compilable wiki examples.

@Drup , can you +1?

agarwal commented 9 years ago

FYI, we have a new project oloop started to address similar issues for regular OCaml code. The hope is to make it easier to write ocaml.org style tutorials, blog posts, books, etc with embedded OCaml code. I'm not sure any of it can be reused for Ocsigen based tutorials, but just wanted to point it out.

Drup commented 9 years ago

Yes, I agree. I'm not sure wikidoc can do that and I hope we will get rid of it and migrate to codoc at some point anyway. There are other rather nice tools (I personally like http://mjambon.com/caml2html.html).

@agarwal oloop doesn't work, we want to compile our files, executing in a toploop is not enough.