updated doc with breaking changes in 2.0