linking helpers ... mostly complete, need docs