support as-is values in update()
add headings so readme is more skimmable