Document consistency model

again, these don't affect the dirty bit, do they? we should be specific here.