updating docs with many-to-many case