updated documentation with heterogeneous case
updated documentation for heterogeneous case