collectors/service - docs update

replaces #67