javadoc added to compareDataStoreStates() methods