reorganized find_partners and added documentation