fleshing out update spec
fleshing out spec