documentation of the solve function
documentation update