add join; update docs