add 'buffer' and 'batch'
some updates to docs