updates to res docs