Maybe some docs are needed about these different states 'changed', 'added' etc. and when they change.