port comparison docs over from 2.0