doc update and ensuring touch is chainable
better dirty tracking