Document imperative methods

[wcandillon]

There is an increasing need to provide documentation for the imperative API: path and image methods for instance. On top of that, by providing some sort of jsdoc integration, we might be able to use it as well for React components. Needs to be investigated.