I actually rather like the mli-files. It's a nice file to read, with the documentation and externally available symbols only. However, the fact that the syntax

I actually rather like the mli-files. It's a nice file to read, with the documentation and externally available symbols only. However, the fact that the syntax is so different is a bit annoying. Sometimes I wrote (haven't written OCaml for some time now..) functions like: let foo: int -> int = fun x -> .. just to make them more similar to the syntax val foo: int -> int in the module types.