add doco on push/pull and DOM 'model'