correct isDirty set
write some readme info