add updated documents from v1.2
update VERSION in Makefile
Merge pull request #1462 from sijchen/after_review1

updated documents from v1.2