chore(docs): better docs for  service (fixes #158 cf. #160)