special-cased join method
update readme