simplified dict update
add initial docs