make docType optional
allow mixed refs (implicit, by name)
add a validation reply
add linkWithInsert

inserts the object then links it to the parent