corrected the description of IsResolved in the documentation
cleaning some comments in service functions