add a few explicit asserts
remove the mentionof linkResource