Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Wiki examples become outdated very often #20

Open
Kakadu opened this issue Mar 15, 2015 · 2 comments
Open

Wiki examples become outdated very often #20

Kakadu opened this issue Mar 15, 2015 · 2 comments

Comments

@Kakadu
Copy link

Kakadu commented Mar 15, 2015

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
Copy link

agarwal commented Mar 15, 2015

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
Copy link
Member

Drup commented Mar 15, 2015

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants