APPSMALL-543: more service method documentation