rafactoring resources to notify service of changes. Documentation of usage