Document the interface in more details

[mseri]

The only thing that prevents us to release the current implementation is the lack of documentation, we should document the interfaces cleanly without sparing details.

[mseri]

Done for owl-ode. We need to do it more explicitly for owl-ode-sundials and owl-ode-odepack