update docs, esp. splice, which has a different contract