review doc, and adapt to some changes in 0.31
review factory doc
prepare 0.31 release notes