added a couple notes about improvements to the join() interface